simmgr.h

用在windows ce/mobile上的Outlook相关的开发源码

} SIMRECORDINFO, FAR *LPSIMRECORDINFO;

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @struct SIMFILEREFRESH | Information about which file(s) have been updated
//
// @comm None
//
// -----------------------------------------------------------------------------
typedef struct simfilerefresh_tag {
    DWORD cbSize;                           // @field Size of the structure in bytes
    DWORD dwParams;                         // @field Indicates valid parameter values
    DWORD dwFlags;                          // @field Combination of SIMFILE_* constants
    DWORD dwFileCount;                      // @field Number of files in the update list
    DWORD rgdwAddress[MAX_FILES];           // @field Array of files
} SIMFILEREFRESH, FAR *LPSIMFILEREFRESH;

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @struct SIMPBECHANGE | Information about which SIM Phonebook entries have changed
//
// @comm None
//
// -----------------------------------------------------------------------------
typedef struct simpbechange_tag {
    DWORD dwEntry;                          // @field The index of the entry that has changed
    DWORD dwStorage;                        // @field SIM_PBSTORAGE_* constant detailing which phonebook this entry is in
} SIMPBECHANGE, FAR *LPSIMPBECHANGE;

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @struct SIMMESSAGECHANGE | Information about which SMS messages on the SIM have changed
//
// @comm None
//
// -----------------------------------------------------------------------------
typedef struct simmessagechange_tag {
    DWORD dwEntry;                          // @field The index of the entry that has changed
    DWORD dwStorage;                        // @field SIM_SMSSTORAGE_* constant details which storage location this entry is in
} SIMMESSAGECHANGE, FAR *LPSIMMESSAGECHANGE;

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @struct SIMSMSSTORAGESTATUS | Status information about when a SIM SMS
//         storage location has become full or has space available.
//
// @comm None
//
// -----------------------------------------------------------------------------
typedef struct simsmsstoragestatus_tag {
    DWORD dwLocation;                       // contains the SIM_SMSSTORAGE_* value
    BOOL fFull;                             // True, the store has become full. False, at least one index has been freed.
} SIMSMSSTORAGESTATUS;


// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func This is the callback function prototype used by SIM Manager when
//       sending notifications.
//
// @comm None
//
// -----------------------------------------------------------------------------
typedef void (*SIMCALLBACK)(
    DWORD dwNotifyCode,                     // @parm Indicates type of notification received
    const void* pData,                      // @parm Points to data structure specific to the notification
    DWORD dwDataSize,                       // @parm Size of data structure in bytes
    DWORD dwParam);                         // @parm Parameter passed to simInititialize


// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func This function must be called by applications in order to use any of the
//       functions in this API.
//
// @comm Passing in a function callback is required only for applications that
//       wish to obtain notifications.
//
// -----------------------------------------------------------------------------
HRESULT SimInitialize(
    DWORD dwFlags,                          // @parm Indicates which notifications to receive
    SIMCALLBACK lpfnCallBack,               // @parm Function callback for notifications, may be NULL if notifications are not desired
    DWORD dwParam,                          // @parm Parameter to pass on each notification function call, may be NULL
    LPHSIM lphSim                           // @parm Points to a HSIM handle to use on subsequent function calls
);


// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func This function deinitializes an HSIM handle.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimDeinitialize(
    HSIM hSim                               // @parm A valid HSIM handle to deinitialize
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Gets the device capabilities of the SIM.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimGetDevCaps(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwCapsType,                       // @parm Which device capabilities are we interested in?
    LPSIMCAPS lpSimCaps                     // @parm Capabilities structure
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Reads a phonebook entry off the SIM card.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimReadPhonebookEntry(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwLocation,                       // @parm A SIMPBSTORAGE_* Constant
    DWORD dwIndex,                          // @parm Index of the entry to retrieve
    LPSIMPHONEBOOKENTRY lpPhonebookEntry    // @parm Points to a phonebook entry structure
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Reads extended phonebook entries from the specified range of indices
//       off the SIM card.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimReadPhonebookEntries(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwLocation,                       // @parm A SIMPBSTORAGE_* Constant
    DWORD dwStartIndex,                     // @parm Starting index in the range of entries to retrieve
    LPDWORD lpdwCount,                      // @parm On input, the total number of entries to read starting from dwStartIndex. On output (if the function succeeds), the actual number of SIMPHONEBOOKENTRYEX structures returned in lpEntries
    LPSIMPHONEBOOKENTRYEX lpEntries,        // @parm Buffer to hold an array of SIMPHONEBOOKENTRYEX structures and associated variable data
    LPDWORD lpdwBufferSize                  // @parm On input, the number of bytes contained in the buffer pointed to by lpEntries. On output, if the function fails it contains the minimum number of bytes to pass for the lpEntries parameter to retrieve the entries.
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Gets the status of a phonebook location.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimGetPhonebookStatus(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwLocation,                       // @parm A SIMPBSTORAGE_* Constant
    LPDWORD lpdwUsed,                       // @parm Number of used locations
    LPDWORD lpdwTotal                       // @parm Total number of locations
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Writes a phonebook entry to the SIM card.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimWritePhonebookEntry(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwLocation,                       // @parm A SIMPBSTORAGE_* Constant
    DWORD dwIndex,                          // @parm Index of the entry to retrieve (may be SIM_PBINDEX_FIRSTAVAILABLE)
    LPSIMPHONEBOOKENTRY lpPhonebookEntry    // @parm Points to a phonebook entry structure
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Writes a phonebook entry to the SIM card.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimWritePhonebookEntryEx(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwLocation,                       // @parm A SIMPBSTORAGE_* Constant
    DWORD dwIndex,                          // @parm Index of the entry to retrieve (may be SIM_PBINDEX_FIRSTAVAILABLE)
    LPSIMPHONEBOOKENTRYEX lpPhonebookEntry  // @parm Points to a extended phonebook entry structure
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Deletes a phonebook entry from the SIM card.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimDeletePhonebookEntry(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwLocation,                       // @parm A SIMPBSTORAGE_* Constant
    DWORD dwIndex                           // @parm Index of the entry to retrieve
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Checks if the SIM is currently awaiting a password.
//
// @comm This is called when powering on the phone.
//
// -----------------------------------------------------------------------------
HRESULT SimGetPhoneLockedState(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    LPDWORD lpdwLockedState                 // @parm Points to a SIM_LOCKEDSTATE_* constant