palmsource sync manager api.mht

有关掌上电脑（Palm OS)上的编程技巧和方法。

html#970332">Sync=20
      Manager Data Structures</A> </P><A name=3D969630></A>
      <P class=3DB1Bullet>=95 <A=20
      =
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CRef_SyncMgr.=
html#970463">Sync=20
      Manager Functions</A> </P><A name=3D969634></A>
      <P class=3DB1Bullet>=95 <A=20
      =
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CRef_SyncMgr.=
html#972963">Sync=20
      Manager Error Codes</A> </P>
      <P class=3DBody><A name=3D969637></A>For information on using the =
Sync Manager=20
      API, see <A=20
      =
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CComp_SyncMgr=
.html#970605">Chapter=20
      5, "Using the Sync Manager API,"</A> in the <I>C/C++ Sync Suite=20
      Companion</I>. </P>
      <DIV class=3DNINoteImportant>
      <HR>
      <A name=3D969642></A><SPAN=20
      style=3D"FONT-WEIGHT: bold; VERTICAL-ALIGN: baseline; =
TEXT-TRANSFORM: none; COLOR: #333; FONT-STYLE: normal; TEXT-DECORATION: =
none">NOTE:=20
      </SPAN>The Sync Manager access only Palm OS databases on the =
handheld. To=20
      access cards in expansion slots, call the Expansion Manager and =
Virtual=20
      File System Manager (see <A=20
      =
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CComp_Expansi=
on.html#976980">Chapter=20
      6, "Using Expansion Technology,"</A> in the <I>C/C++ Sync Suite=20
      Companion</I>). <BR><BR>The term "card" used in the context of the =
Sync=20
      Manager refers to the primary storage RAM in the handheld and a =
"card=20
      number" identifies one or more such cards. (Handhelds with only =
one=20
      primary storage card always assign them a card number of 0.) Be =
careful=20
      not to confuse "cards" accessed by the Sync Manager with =
"expansion cards"=20
      accessed by the Expansion Manager and Virtual File System Manager. =

      <HR>
      </DIV>
      <H2 class=3DHaHeadA><A name=3D969651></A>Sync Manager Versions <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=3D969652></A>The Sync Manager continues to =
evolve with=20
      new functions and new versions of existing functions. Each version =
of the=20
      Sync Manager API has a major version number and a minor version =
number.=20
      You can determine the version of the Sync Manager API that you are =
using=20
      by calling the <A=20
      =
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CRef_SyncMgr.=
html#971147"><SPAN=20
      style=3D"FONT-FAMILY: monospace">SyncGetAPIVersion</SPAN></A> =
function. </P>
      <P class=3DBody><A name=3D969656></A>The Sync Manager maintains =
backward=20
      compatibility within a major version. The Sync Manager minor =
version=20
      number changes when new functions are added or bugs are fixed. =
This=20
      document includes version information for each function. </P>
      <DIV class=3DNINoteImportant>
      <HR>
      <A name=3D969657></A><SPAN=20
      style=3D"FONT-WEIGHT: bold; VERTICAL-ALIGN: baseline; =
TEXT-TRANSFORM: none; COLOR: #333; FONT-STYLE: normal; TEXT-DECORATION: =
none">NOTE:=20
      </SPAN>Conduits developed with the Conduit Development Kit can be =
used on=20
      desktop computers that are running version 2.0 or later of the =
Sync=20
      Manager API. Your conduits will not operate on desktop computers =
that have=20
      earlier versions of the Sync Manager API.=20
      <HR>
      </DIV>
      <P class=3DBody><A name=3D969658></A>If your conduit depends on =
functions that=20
      are available only in certain versions of the Sync Manager API, =
you need=20
      to determine the version of the Sync Manager API with which you =
are=20
      dealing on a specific installation. To do so, call the <SPAN=20
      style=3D"FONT-FAMILY: monospace">SyncGetAPIVersion</SPAN> =
function, which=20
      returns both the major version number and minor version number of =
the Sync=20
      Manager API on the desktop computer. </P>
      <P class=3DBody><A name=3D969659></A>For example, if your conduit =
depends on a=20
      function that was added in version 2.1 of the Sync Manager API, =
you need=20
      to call the <SPAN style=3D"FONT-FAMILY: =
monospace">SyncGetAPIVersion</SPAN>=20
      function and then verify that the major number is <SPAN=20
      style=3D"FONT-FAMILY: monospace">2</SPAN> or greater and that the =
minor=20
      version number is <SPAN style=3D"FONT-FAMILY: monospace">1</SPAN> =
or=20
      greater. </P>
      <P class=3DBody><A name=3D969660></A>Several of the Sync Manager =
API function=20
      have two versions: one that ends in the "Ex" suffix and one that =
does not.=20
      The "Ex" suffix stands for "extended" and is used with the newer =
version=20
      of a function that adds functionality. For example, the <A=20
      =
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CRef_SyncMgr.=
html#970786"><SPAN=20
      style=3D"FONT-FAMILY: monospace">SyncCloseDB</SPAN></A> and <A=20
      =
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CRef_SyncMgr.=
html#970833"><SPAN=20
      style=3D"FONT-FAMILY: monospace">SyncCloseDBEx</SPAN></A> =
functions both=20
      close a database on the handheld; <SPAN=20
      style=3D"FONT-FAMILY: monospace">SyncCloseDBEx</SPAN> takes an =
additional=20
      option flags argument and can update the modification and backup =
dates of=20
      the database while closing it. </P>
      <H2 class=3DHaHeadA><A name=3D969669></A>HotSync Manager and Sync =
Manager API=20
      Versions <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=3D969670></A>You need to know that the =
version of the=20
      HotSync<SUP>=AE</SUP> Manager running on a specific desktop =
computer is not=20
      necessarily the same as the version of the Sync Manager API =
installed on=20
      that system. The calls that your conduit can make are dependent on =
the=20
      Sync Manager API version installed on the desktop computer. </P>
      <DIV class=3DNINoteImportant>
      <HR>
      <A name=3D994724></A><SPAN=20
      style=3D"FONT-WEIGHT: bold; VERTICAL-ALIGN: baseline; =
TEXT-TRANSFORM: none; COLOR: #333; FONT-STYLE: normal; TEXT-DECORATION: =
none">NOTE:=20
      </SPAN>CDK version 4.03 supports conduit development only for =
HotSync=20
      Manager versions <I>4.0 and later</I> (which corresponds to Sync =
Manager=20
      API versions 2.3 and later). Newer HotSync Manager versions try to =

      maintain support for the earlier versions, but PalmSource, Inc. =
does not=20
      guarantee this support for conduits created with CDK 4.03. =
PalmSource=20
      recommends that you upgrade to HotSync Manager version 4.0 or =
later.=20
      <HR>
      </DIV>
      <P class=3DBody><A name=3D969675></A><A=20
      =
href=3D"http://www.palmos.com/dev/support/docs/conduits/win/CRef_SyncMgr.=
html#969679">Table=20
      2.1</A><SPAN=20
      style=3D"FONT-WEIGHT: normal; VERTICAL-ALIGN: baseline; =
TEXT-TRANSFORM: none; COLOR: #333; FONT-STYLE: normal; TEXT-DECORATION: =
none">=20
      shows </SPAN>which versions of HotSync Manager use which versions =
of the=20
      Sync Manager. It also states which versions are supported with =
this CDK.=20
      </P>
      <H5 class=3DTgTable>
      <TABLE cellSpacing=3D0 cellPadding=3D5 border=3D1>
        <CAPTION><A name=3D969679></A>
        <DIV class=3DTableTitle>Table 2.1 Comparison of HotSync Manager =
and Sync=20
        Manager versions&nbsp;</DIV></CAPTION>
        <TBODY>
        <TR vAlign=3Dtop bgColor=3D#cccccc>
          <TH><A name=3D969688></A>
            <DIV class=3DCellHeading>HotSync Manager Version</DIV></TH>
          <TH><A name=3D969690></A>
            <DIV class=3DCellHeading>Sync Manager API Version</DIV></TH>
          <TH><A name=3D969692></A>
            <DIV class=3DCellHeading>Supported with CDK =
4.03</DIV></TH></TR>
        <TR vAlign=3Dtop>
          <TD><A name=3D969694></A>
            <DIV class=3DCellBody>1.0</DIV></TD>
          <TD><A name=3D969696></A>
            <DIV class=3DCellBody>1.0</DIV></TD>
          <TD><A name=3D969698></A>
            <DIV class=3DCellBody>No</DIV></TD></TR>
        <TR vAlign=3Dtop>
          <TD><A name=3D969700></A>
            <DIV class=3DCellBody>1.1</DIV></TD>
          <TD><A name=3D969702></A>
            <DIV class=3DCellBody>2.0</DIV></TD>
          <TD><A name=3D969704></A>
            <DIV class=3DCellBody>No</DIV></TD></TR>
        <TR vAlign=3Dtop>
          <TD><A name=3D969706></A>
            <DIV class=3DCellBody>1.2</DIV></TD>
          <TD><A name=3D969708></A>
            <DIV class=3DCellBody>1.0</DIV></TD>
          <TD><A name=3D969710></A>
            <DIV class=3DCellBody>No</DIV></TD></TR>
        <TR vAlign=3Dtop>
          <TD><A name=3D969712></A>
            <DIV class=3DCellBody>2.0</DIV></TD>
          <TD><A name=3D969714></A>
            <DIV class=3DCellBody>2.0</DIV></TD>
          <TD><A name=3D969716></A>
            <DIV class=3DCellBody>No</DIV></TD></TR>
        <TR vAlign=3Dtop>
          <TD><A name=3D969718></A>
            <DIV class=3DCellBody>2.1</DIV></TD>
          <TD><A name=3D969720></A>
            <DIV class=3DCellBody>2.1</DIV></TD>
          <TD><A name=3D969722></A>
            <DIV class=3DCellBody>No</DIV></TD></TR>
        <TR vAlign=3Dtop>
          <TD><A name=3D969724></A>
            <DIV class=3DCellBody>3.0</DIV></TD>
          <TD><A name=3D969726></A>
            <DIV class=3DCellBody>2.2</DIV></TD>
          <TD><A name=3D969728></A>
            <DIV class=3DCellBody>No</DIV></TD></TR>
        <TR vAlign=3Dtop>
          <TD><A name=3D969730></A>
            <DIV class=3DCellBody>3.0.1</DIV></TD>
          <TD><A name=3D969732></A>
            <DIV class=3DCellBody>2.2</DIV></TD>
          <TD><A name=3D994748></A>
            <DIV class=3DCellBody>No</DIV></TD></TR>
        <TR vAlign=3Dtop>
          <TD><A name=3D969736></A>
            <DIV class=3DCellBody>3.0.2</DIV></TD>
          <TD><A name=3D969738></A>
            <DIV class=3DCellBody>2.2</DIV></TD>
          <TD><A name=3D994750></A>
            <DIV class=3DCellBody>No</DIV></TD></TR>
        <TR vAlign=3Dtop>
          <TD><A name=3D969742></A>
            <DIV class=3DCellBody>3.0.3</DIV></TD>
          <TD><A name=3D969744></A>
            <DIV class=3DCellBody>2.2</DIV></TD>
          <TD><A name=3D994752></A>
            <DIV class=3DCellBody>No</DIV></TD></TR>
        <TR vAlign=3Dtop>
          <TD><A name=3D969748></A>
            <DIV class=3DCellBody>3.0.4</DIV></TD>
          <TD><A name=3D969750></A>
            <DIV class=3DCellBody>2.2</DIV></TD>
          <TD><A name=3D994754></A>
            <DIV class=3DCellBody>No</DIV></TD></TR>
        <TR vAlign=3Dtop>
          <TD><A name=3D969754></A>
            <DIV class=3DCellBody>3.0.5</DIV></TD>
          <TD><A name=3D969756></A>
            <DIV class=3DCellBody>2.2</DIV></TD>
          <TD><A name=3D994756></A>
            <DIV class=3DCellBody>No</DIV></TD></TR>
        <TR vAlign=3Dtop>
          <TD><A name=3D969760></A>
            <DIV class=3DCellBody>3.1</DIV></TD>
          <TD><A name=3D969762></A>
            <DIV class=3DCellBody>2.2</DIV></TD>
          <TD><A name=3D994758></A>
            <DIV class=3DCellBody>No</DIV></TD></TR>
        <TR vAlign=3Dtop>
          <TD><A name=3D969766></A>
            <DIV class=3DCellBody>4.0.x</DIV></TD>
          <TD><A name=3D969768></A>
            <DIV class=3DCellBody>2.3</DIV></TD>
          <TD><A name=3D969770></A>
            <DIV class=3DCellBody>Yes</DIV></TD></TR>
        <TR vAlign=3Dtop>
          <TD><A name=3D969778></A>
            <DIV class=3DCellBody>Shipped in CDK 4.03</DIV></TD>
          <TD><A name=3D969780></A>
            <DIV class=3DCellBody>2.3</DIV></TD>
          <TD><A name=3D969782></A>
            <DIV =
class=3DCellBody>Yes</DIV></TD></TR></TBODY></TABLE></H5>
      <DIV class=3DNINoteImportant>
      <HR>
      <A name=3D969796></A><SPAN=20
      style=3D"FONT-WEIGHT: bold; VERTICAL-ALIGN: baseline; =
TEXT-TRANSFORM: none; COLOR: #333; FONT-STYLE: normal; TEXT-DECORATION: =
none">NOTE:=20
      </SPAN>You cannot use the CDK to develop a conduit for any version =
of=20
      HotSync Manager earlier than 1.1 or for any version of the Sync =
Manager=20
      API earlier than 2.0. <BR><BR>When describing the version =
compatibility of=20
      a function, this document uses "All" to indicate that the function =
is=20
      compatible with versions 2.0 and later of the Sync Manager API.=20
      <HR>
      </DIV>
      <H2 class=3DHaHeadA><A name=3D969799></A>Sync Manager Constants <A =

      =
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=3D969800></A>This section describes the =
constants that=20
      you use with the Sync Manager functions. </P>
      <H2 class=3DHBHeadB><A name=3D969801></A>General Constants <A=20
      =