WrapStoreEntryID

適用対象: Outlook 2013 | Outlook 2016

メッセージ ストアの内部エントリ識別子を、メッセージング システムで使用可能なエントリ識別子に変換します。

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 構造体へのポインターへのポインター。

戻り値

なし。

注釈

メッセージ ストア オブジェクトには内部エントリ識別子が保持されます。これは、そのメッセージ ストアを持つサービス プロバイダーのコア識別子に対してのみ意味があります。 その他のメッセージング コンポーネントの場合、MAPI は、メッセージ ストアに属しているとして認識できるようにする内部エントリ識別子のラップされたバージョンを提供します。 コア ID サービス プロバイダーには、常に元のラップされていないメッセージ ストア エントリ識別子を指定する必要があります。クライアント アプリケーションには、常にラップされたバージョンを指定する必要があります。このバージョンは、メッセージング ドメイン内および他のドメイン内の任意の場所で使用できます。

サービス プロバイダーは、 WrapStoreEntryID 関数または WrapStoreEntryID 関数を呼び出す IMAPISupport::WrapStoreEntryID メソッドを使用して、メッセージ ストアエントリ識別子を ラップ できます。 プロバイダーは、メッセージ ストアの PR_ENTRYID (PidTagEntryId) プロパティを公開するとき、またはプロファイル セクションに書き込む場合、および PR_STORE_ENTRYID (PidTagStoreEntryId) プロパティを公開するときに、エントリ識別子をラップする必要があります。 MAPI は、 IMAPISession::OpenMsgStore 呼び出しに応答するときにメッセージ ストア エントリ識別子をラップします。

クライアント アプリケーションがラップされたメッセージ ストアエントリ識別子 (IMAPISession::OpenEntry 呼び出しなど) を MAPI に渡すと、MAPI はエントリ識別子を使用する前にラップを解除してから、IMSProvider::Logon や IMSProvider::CompareStoreID などのプロバイダー メソッドを呼び出します。