IMAPISupport::WrapStoreEntryID
適用於:Outlook 2013 |Outlook 2016
將訊息存放區的內部專案標識碼轉換成MAPI標準格式的專案標識碼。
HRESULT WrapStoreEntryID(
ULONG cbOrigEntry,
LPENTRYID lpOrigEntry,
ULONG FAR * lpcbWrappedEntry,
LPENTRYID FAR * lppWrappedEntry
);
參數
cbOrigEntry
[in] lpOrigEntry 參數所指向之專案標識碼中的位元組計數。
lpOrigEntry
[in]訊息存放區之私人項目標識碼的指標。
lpcbWrappedEntry
[out] lppWrappedEntry 參數所指向之專案標識符中位元組計數的指標。
lppWrappedEntry
[out]包裝項目標識碼指標的指標。
傳回值
S_OK
已成功包裝項目標識碼。
註解
針對所有服務提供者支持物件實作 IMAPISupport::WrapStoreEntryID 方法。 服務提供者會使用 WrapStoreEntryID 讓 MAPI 為包裝存放區內部專案識別碼的訊息存放區產生專案標識碼。
呼叫者注意事項
當用戶端呼叫訊息存放區的 IMAPIProp::GetProps 方法來擷取其 PR_STORE_ENTRYID (PidTagStoreEntryId) 屬性,而且您的郵件存放區使用私用格式的專案標識符時,請呼叫 WrapStoreEntryID 並傳回 lppWrappedEntry 參數所指向的專案標識符。
呼叫 IMSProvider::Logon 和 IMSLogon::CompareEntryIDs 方法一律會取得存放區的私人專案標識符;包裝的版本只會在用戶端應用程式和 MAPI 之間使用。
當您完成使用專案標識符時,請使用MAPIFreeBuffer函式,釋放 lppWrappedEntry 參數所指向之專案標識碼的記憶體。