simmgr.h

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

);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Sends a password to unlock the phone.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimUnlockPhone(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    LPTSTR lpszPassword,                    // @parm Points to password string
    LPTSTR lpszNewPin                       // @parm Some locked states require a second password (e.g. PUK requires a new PIN to replace the old, presumably forgotten PIN)
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Gets the locking status of the phone.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimGetLockingStatus(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwLockingFacility,                // @parm A SIMLOCKFACILITY_* constant
    LPTSTR lpszPassword,                    // @parm Some facilities require a password
    BOOL *pfEnabled                         // @parm Enabled or diabled
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Sets the locking status of the phone.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimSetLockingStatus(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwLockingFacility,                // @parm A SIMLOCKFACILITY_* constant
    LPTSTR lpszPassword,                    // @parm Some facilities require a password
    BOOL fEnabled                           // @parm Enable or diable
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Changes a locking password.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimChangeLockingPassword(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwLockingFacility,                // @parm A SIMLOCKFACILITY_* constant
    LPTSTR lpszOldPassword,                 // @parm The old password
    LPTSTR lpszNewPassword                  // @parm The new password
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Gets the status of a SMS storage location.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimGetSmsStorageStatus(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwStorage,                        // @parm A SIM_SMSSTORAGE_* constant
    LPDWORD lpdwUsed,                       // @parm Number of used locations
    LPDWORD lpdwTotal                       // @parm Total number of locations
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Reads an SMS from a particular storage location.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimReadMessage(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwStorage,                        // @parm A SIM_SMSSTORAGE_* constant
    DWORD dwIndex,                          // @parm Index of the entry to retrieve
    LPSIMMESSAGE lpSimMessage               // @parm Points to an SMS message structure
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Writes an SMS to a particular storage location.
//
// @comm Note that SMS messages are always written to the first available storage location
// @comm lpdwIndex will be set to the index to which the message was written
//
// -----------------------------------------------------------------------------
HRESULT SimWriteMessage(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwStorage,                        // @parm A SIM_SMSSTORAGE_* constant
    LPDWORD lpdwIndex,                      // @parm Set to the index where the message was written
    LPSIMMESSAGE lpSimMessage               // @parm Points to an SMS message structure
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Deletes an SMS from a particular storage location.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimDeleteMessage(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwStorage,                        // @parm A SIM_SMSSTORAGE_* constant
    DWORD dwIndex                           // @parm Index of the entry to retrieve
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Reads a file form the SIM.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimReadRecord(
    HSIM hSim,                                  // @parm Points to a valid HSIM handle
    DWORD dwAddress,                            // @parm SIM address
    DWORD dwRecordType,                         // @parm A SIM_RECORDTYPE_* constant
    DWORD dwIndex,                              // @parm Applies only to SIM_RECORDTYPE_CYCLIC and SIM_RECORDTYPE_LINEAR, otherwise ignored
    __out_bcount(*lpdwBytesRead) LPBYTE lpData, // @parm Data buffer
    DWORD dwBufferSize,                         // @parm Size of data buffer
    LPDWORD lpdwBytesRead                       // @parm Number of bytes read
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Writes a file to the SIM.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimWriteRecord(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwAddress,                        // @parm SIM address
    DWORD dwRecordType,                     // @parm A SIM_RECORDTYPE_* constant
    DWORD dwIndex,                          // @parm Applies only to SIM_RECORDTYPE_CYCLIC and SIM_RECORDTYPE_LINEAR, otherwise ignored
    __in_bcount(dwByteCount) LPBYTE lpData, // @parm Data to write
    DWORD dwByteCount                       // @parm Number of bytes to write
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Gets information about a particular record.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimGetRecordInfo(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwAddress,                        // @parm SIM address
    LPSIMRECORDINFO lpSimRecordInfo         // @parm Points to a SIM record information structure
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Gets the phonebook capabilities of the SIM.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimGetPhonebookCapabilities(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    LPSIMPHONEBOOKCAPS lpCapabilities       // @parm Points to a SIMPHONEBOOKCAPS structure
);


// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Reads the name value for a given index and tag.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimReadPhonebookTag(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwTag,                            // @parm A SIM_PBTAG_* constant
    DWORD dwIndex,                          // @parm Index of tag to read
    __out_ecount(cchNameSize) LPTSTR szName,// @parm Returned name of tag
    DWORD cchNameSize                       // @parm Size of name in characters
);

// -----------------------------------------------------------------------------
//
// @doc EXTERNAL
//
// @func Writes the name value to a given index and tag.
//
// @comm None
//
// -----------------------------------------------------------------------------
HRESULT SimWritePhonebookTag(
    HSIM hSim,                              // @parm Points to a valid HSIM handle
    DWORD dwTag,                            // @parm A SIM_PBTAG_* constant
    DWORD dwIndex,                          // @parm Index to write
    LPTSTR szName                           // @parm Name for index
);


#ifdef __cplusplus
}
#endif

#endif // _SIMMGR_H_