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 パラメーターによって指されているエントリ識別子のメモリを解放します。