WrapStoreEntryID
適用於:Outlook 2013 |Outlook 2016
將訊息存放區的內部專案標識碼轉換成訊息系統更容易使用的專案標識碼。
屬性 | 值 |
---|---|
標頭檔: |
Mapidefs.h |
實作者: |
Mapi |
通話者: |
用戶端應用程式和服務提供者 |
WrapStoreEntryID(
ULONG ulFlags,
LPSTR szDLLName,
ULONG cbOrigEntry,
LPENTRYID lpOrigEntry,
ULONG * lpcbWrappedEntry,
LPENTRYID * lppWrappedEntry
);
參數
ulFlags
[in]旗標的位掩碼。 您可以設定下列旗標:
MAPI_UNICODE
字串是 Unicode 格式。 如果未設定MAPI_UNICODE旗標,則字串會是 ANSI 格式。
szDLLName
[in]訊息存放區提供者 DLL 的名稱。
cbOrigEntry
[in]訊息存放區的原始項目標識碼大小,以位元組為單位。
lpOrigEntry
[in]包含原始專案標識碼之 ENTRYID 結構的指標。
lpcbWrappedEntry
[out]新專案標識元大小的指標,以位元組為單位。
lppWrappedEntry
[out]包含新專案標識碼之 ENTRYID 結構的指標。
傳回值
無。
註解
訊息存放區物件會保留內部專案標識符,這僅對具有該訊息存放區的服務提供者 coresident 有意義。 針對其他傳訊元件,MAPI 會提供內部專案標識碼的包裝版本,使其可辨識為屬於訊息存放區。 Coresident 服務提供者應一律獲得原始未包裝的訊息存放區專案標識符;用戶端應用程式應一律獲得包裝的版本,然後可在傳訊網域和其他網域中的任何位置使用。
服務提供者可以使用 WrapStoreEntryID 函式或呼叫 WrapStoreEntryID 函式的 IMAPISupport::WrapStoreEntryID 方法來包裝訊息存放區專案標識符。 提供者必須將郵件存放區的 PR_ENTRYID公開 (PidTagEntryId) 屬性或寫入配置檔區段,以及公開 PR_STORE_ENTRYID (PidTagStoreEntryId) 屬性時,包裝專案標識符。 MAPI 會在回應 IMAPISession::OpenMsgStore 呼叫時包裝訊息存放區專案標識符。
當用戶端應用程式將包裝的郵件存放區專案標識符傳遞至MAPI時,例如在 IMAPISession::OpenEntry 呼叫中,MAPI 會先解除包裝專案標識符,再使用它來呼叫提供者方法,例如 IMSProvider::Logon 或 IMSProvider::CompareStoreIDs。