📄 palmsource sync manager api.mht
字号:
the=20
database is currently opened.<BR><B><BR>Note:</B> Do not =
pass this=20
flag when creating a database. It is for system use=20
only!</TD></TR></TBODY></TABLE></DIV></H5>
<H5 class=3DP1><A name=3D969844></A>
<DIV class=3DP1Parameter>
<TABLE cellSpacing=3D0 cellPadding=3D5 border=3D0>
<TBODY>
<TR>
<TD vAlign=3Dtop width=3D180><SPAN=20
style=3D"FONT-FAMILY: monospace">eReadOnly </SPAN></TD>
<TD vAlign=3Dtop></SPAN>When this flag is set, indicates that =
the=20
database is a read-only (ROM)=20
database.</TD></TR></TBODY></TABLE></DIV></H5>
<H5 class=3DP1><A name=3D969845></A>
<DIV class=3DP1Parameter>
<TABLE cellSpacing=3D0 cellPadding=3D5 border=3D0>
<TBODY>
<TR>
<TD vAlign=3Dtop width=3D180><SPAN=20
style=3D"FONT-FAMILY: monospace">eResetAfterInstall =
</SPAN></TD>
<TD vAlign=3Dtop></SPAN>When this flag is set, indicates that =
the=20
handheld needs to be reset after the database is installed=20
(actually, after the synchronization involving the database =
is=20
complete).</TD></TR></TBODY></TABLE></DIV></H5>
<H5 class=3DP1><A name=3D969846></A>
<DIV class=3DP1Parameter>
<TABLE cellSpacing=3D0 cellPadding=3D5 border=3D0>
<TBODY>
<TR>
<TD vAlign=3Dtop width=3D180><SPAN=20
style=3D"FONT-FAMILY: monospace">eResource </SPAN></TD>
<TD vAlign=3Dtop></SPAN>When this flag is set, indicates that =
the=20
database is a resource database (as opposed to a record =
database).=20
If you do not specify this flag, the database is considered =
a record=20
database. Most conduits work with record=20
databases.</TD></TR></TBODY></TABLE></DIV></H5>
<H2 class=3DHBHeadB><A name=3D969850></A>Database Information =
Retrieval=20
Constants <A=20
=
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CRef_SyncMgr.=
html#969592"><SPAN=20
class=3Dnav>^TOP^</SPAN></A> </H2>
<P class=3DBody><A name=3D969851></A>You can combine the database =
information=20
retrieval constants together to specify how Sync Manager =
operations=20
retrieve data about the database. </P>
<H5 class=3DP1><A name=3D969853></A>
<DIV class=3DP1Parameter>
<TABLE cellSpacing=3D0 cellPadding=3D5 border=3D0>
<TBODY>
<TR>
<TD vAlign=3Dtop width=3D180><SPAN=20
style=3D"FONT-FAMILY: =
monospace">SYNC_DB_INFO_OPT_GET_ATTRIBUTES=20
</SPAN></TD>
<TD vAlign=3Dtop></SPAN>Set this flag to indicate that =
database search=20
operations are to retrieve database attribute information. =
You can=20
omit this to optimize =
performance.</TD></TR></TBODY></TABLE></DIV></H5>
<H5 class=3DP1><A name=3D969855></A>
<DIV class=3DP1Parameter>
<TABLE cellSpacing=3D0 cellPadding=3D5 border=3D0>
<TBODY>
<TR>
<TD vAlign=3Dtop width=3D180><SPAN=20
style=3D"FONT-FAMILY: monospace">SYNC_DB_INFO_OPT_GET_SIZE =
</SPAN></TD>
<TD vAlign=3Dtop></SPAN>Set this flag to indicate that =
database search=20
operations are to retrieve record count and data size =
information.=20
You can omit this to optimize=20
performance.</TD></TR></TBODY></TABLE></DIV></H5>
<H5 class=3DP1><A name=3D969857></A>
<DIV class=3DP1Parameter>
<TABLE cellSpacing=3D0 cellPadding=3D5 border=3D0>
<TBODY>
<TR>
<TD vAlign=3Dtop width=3D180><SPAN=20
style=3D"FONT-FAMILY: =
monospace">SYNC_DB_INFO_OPT_GET_MAX_REC_SIZE=20
</SPAN></TD>
<TD vAlign=3Dtop></SPAN>Set this flag to indicate that =
database search=20
operations are to retrieve the maximum record or resource =
size=20
information. You can omit this to optimize performance. =
<B>Note:</B>=20
this flag applies only to the <SPAN=20
style=3D"FONT-FAMILY: monospace">SyncReadOpenDbInfo</SPAN>=20
function.</TD></TR></TBODY></TABLE></DIV></H5>
<H2 class=3DHBHeadB><A name=3D969860></A>Database Open Mode =
(eDbOpenModes)=20
Constants <A=20
=
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CRef_SyncMgr.=
html#969592"><SPAN=20
class=3Dnav>^TOP^</SPAN></A> </H2>
<P class=3DBody><A name=3D969861></A>You can combine the database =
open mode=20
constants together to specify in what mode to open a database. =
</P><PRE class=3DPreformatted>enum eDbOpenModes { eDbShowSecret =3D =
0x0010,<A name=3D969862> </A>
&=
nbsp; eDbExclusive =3D =
0x0020,<A name=3D969863> </A>
&=
nbsp; eDbWrite =3D =
0x0040,<A name=3D969864> </A>
&=
nbsp; eDbRead =3D =
0x0080<A name=3D969865> </A>
&=
nbsp; };<A name=3D969866> </A>
</PRE>
<P class=3DBody><A name=3D969867></A>The following rules explain =
how to use=20
the database open mode constants: </P><A name=3D969868></A>
<P class=3DB1Bullet>=95 You generally include the <SPAN=20
style=3D"FONT-FAMILY: monospace">eDbShowSecret</SPAN> flag; =
otherwise, some=20
of the Sync Manager functions will not return records that are =
marked as=20
private.</P><A name=3D969869></A>
<P class=3DB1Bullet>=95 If you are opening a database for reading =
only,=20
specify <BR><SPAN=20
style=3D"FONT-FAMILY: =
monospace">(eDbRead|eDbShowSecret)</SPAN>.</P><A=20
name=3D969870></A>
<P class=3DB1Bullet>=95 If you are opening a database for reading =
and writing,=20
specify <SPAN=20
style=3D"FONT-FAMILY: =
monospace">(eDbRead|eDbWrite|eDbShowSecret)</SPAN>.</P><A=20
name=3D969871></A>
<P class=3DB1Bullet>=95 You can use the <SPAN=20
style=3D"FONT-FAMILY: monospace">eDbExclusive</SPAN> flag to open =
the=20
database in exclusive mode, which means that nothing else on the =
handheld=20
can use the database until you close it. This also means that your =
open=20
call will fail if anything else on the handheld is using the =
database.=20
Note that <SPAN style=3D"FONT-FAMILY: =
monospace">eDbExclusive</SPAN> is of=20
limited value, since applications are not allowed to run on the =
handheld=20
during synchronization operations.</P>
<H5 class=3DP1><A name=3D969872></A>
<DIV class=3DP1Parameter>
<TABLE cellSpacing=3D0 cellPadding=3D5 border=3D0>
<TBODY>
<TR>
<TD vAlign=3Dtop width=3D180><SPAN=20
style=3D"FONT-FAMILY: monospace">eDbShowSecret </SPAN></TD>
<TD vAlign=3Dtop></SPAN>Open the database with full access to =
the=20
user's secret records. <BR><B><BR>Note:</B> only two of the =
Sync=20
Manager functions are currently affected by this mode: the =
<A=20
=
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CRef_SyncMgr.=
html#971897"><SPAN=20
style=3D"FONT-FAMILY: =
monospace">SyncReadNextRecInCategory</SPAN></A>=20
and <A=20
=
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CRef_SyncMgr.=
html#971813"><SPAN=20
style=3D"FONT-FAMILY: =
monospace">SyncReadNextModifiedRecInCategory</SPAN></A>=20
functions skip secret records if you open the database =
without=20
specifying the <SPAN=20
style=3D"FONT-FAMILY: monospace">eDbShowSecret</SPAN> flag.=20
</TD></TR></TBODY></TABLE></DIV></H5>
<H5 class=3DP1><A name=3D969880></A>
<DIV class=3DP1Parameter>
<TABLE cellSpacing=3D0 cellPadding=3D5 border=3D0>
<TBODY>
<TR>
<TD vAlign=3Dtop width=3D180><SPAN=20
style=3D"FONT-FAMILY: monospace">eDbExclusive </SPAN></TD>
<TD vAlign=3Dtop></SPAN>Open the database for exclusive =
access. This=20
means that if the database is already opened, you will be =
denied=20
access. If you successfully open the database in exclusive =
mode, no=20
one else will be able to access it until you close the=20
database.</TD></TR></TBODY></TABLE></DIV></H5>
<H5 class=3DP1><A name=3D969881></A>
<DIV class=3DP1Parameter>
<TABLE cellSpacing=3D0 cellPadding=3D5 border=3D0>
<TBODY>
<TR>
<TD vAlign=3Dtop width=3D180><SPAN=20
style=3D"FONT-FAMILY: monospace">eDbWrite </SPAN></TD>
<TD vAlign=3Dtop></SPAN>Open the database for write=20
access.</TD></TR></TBODY></TABLE></DIV></H5>
<H5 class=3DP1><A name=3D969882></A>
<DIV class=3DP1Parameter>
<TABLE cellSpacing=3D0 cellPadding=3D5 border=3D0>
<TBODY>
<TR>
<TD vAlign=3Dtop width=3D180><SPAN=20
style=3D"FONT-FAMILY: monospace">eDbRead </SPAN></TD>
<TD vAlign=3Dtop></SPAN>Open the database for read=20
access.</TD></TR></TBODY></TABLE></DIV></H5>
<H2 class=3DHBHeadB><A name=3D969886></A>Miscellaneous Database =
Flag=20
(eMiscDbListFlags) Constants <A=20
=
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CRef_SyncMgr.=
html#969592"><SPAN=20
class=3Dnav>^TOP^</SPAN></A> </H2>
<P class=3DBody><A name=3D969887></A>The miscellaneous database =
list flag=20
constants are returned in the <SPAN=20
style=3D"FONT-WEIGHT: normal; VERTICAL-ALIGN: baseline; =
TEXT-TRANSFORM: none; COLOR: #333; FONT-STYLE: normal; TEXT-DECORATION: =
none">m_miscFlags</SPAN>=20
of an object of the <A=20
=
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CRef_SyncMgr.=
html#970099"><SPAN=20
style=3D"FONT-FAMILY: monospace">CDbList</SPAN></A> structure when =
you call=20
certain of the Sync Manager functions; for example, the <A=20
=
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CRef_SyncMgr.=
html#971588"><SPAN=20
style=3D"FONT-FAMILY: monospace">SyncReadDBList</SPAN></A> =
function. </P><PRE class=3DPreformatted>enum eMiscDbListFlags {<A =
name=3D969894> </A>
eMiscDbFlagExcludeFromSync =3D 0x0080,<A name=3D969895> </A>
eMiscDbFlagRamBased =
=3D 0x0040<A name=3D969896> </A>
}<A name=3D969897> </A>
#define eExcludeFromSync eMiscDbFlagExcludeFromSync<A name=3D969899> =
</A>
</PRE>
<H5 class=3DP1><A name=3D969901></A>
<DIV class=3DP1Parameter>
<TABLE cellSpacing=3D0 cellPadding=3D5 border=3D0>
<TBODY>
<TR>
<TD vAlign=3Dtop width=3D180><SPAN=20
style=3D"FONT-FAMILY: monospace">eMiscDbFlagExcludeFromSync =
</SPAN></TD>
<TD vAlign=3Dtop></SPAN>When set, indicates that the database =
is to be=20
excluded from the synchronization operations. This is =
typically the=20
result of the user disabling synchronization for the =
application=20
that owns the database on the handheld. Available with Palm =
OS=20
software versions 2.0 or later. <BR><BR>This constant =
replaces the=20
older constant <SPAN=20
style=3D"FONT-FAMILY: =
monospace">eExcludeFromSync</SPAN>.</TD></TR></TBODY></TABLE></DIV></H5>
<H5 class=3DP1><A name=3D969903></A>
<DIV class=3DP1Parameter>
<TABLE cellSpacing=3D0 cellPadding=3D5 border=3D0>
<TBODY>
<TR>
<TD vAlign=3Dtop width=3D180><SPAN=20
style=3D"FONT-FAMILY: monospace">eMiscDbFlagRamBased =
</SPAN></TD>
<TD vAlign=3Dtop></SPAN>When set, indicates that the database =
is=20
located in RAM; if not set, the database is stored in ROM. =
Available=20
with Palm OS software versions 3.0 or=20
later.</TD></TR></TBODY></TABLE></DIV></H5>
<H2 class=3DHBHeadB><A name=3D969906></A>Option Flag Constants for =
SyncCloseDBEx <A=20
=
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CRef_SyncMgr.=
html#969592"><SPAN=20
class=3Dnav>^TOP^</SPAN></A> </H2>
<P class=3DBody><A name=3D969907></A>You can combine the database =
close=20
constants together to specify actions to take when closing a =
database.=20
</P>
<H5 class=3DP1><A name=3D969909></A>
<DIV class=3DP1Parameter>
<TABLE cellSpacing=3D0 cellPadding=3D5 border=3D0>
<TBODY>
<TR>
<TD vAlign=3Dtop width=3D180><SPAN=20
style=3D"FONT-FAMILY: =
monospace">SYNC_CLOSE_DB_OPT_UPDATE_BACKUP_DATE=20
</SPAN></TD>
<TD vAlign=3Dtop></SPAN>Specify this to indicate that the =
database's=20
backup date is to be updated after it is=20
closed.</TD></TR></TBODY></TABLE></DIV></H5>
<H5 class=3DP1><A name=3D1045274></A>
<DIV class=3DP1Parameter>
<TABLE cellSpacing=3D0 cellPadding=3D5 border=3D0>
<TBODY>
<TR>
<TD vAlign=3Dtop width=3D180><SPAN=20
style=3D"FONT-FAMILY: =
monospace">SYNC_CLOSE_DB_OPT_UPDATE_MOD_DATE=20
</⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -