IMAPISupport::SetProviderUID
適用対象: Outlook 2013 | Outlook 2016
サービス プロバイダーを一意に表す MAPIUID 構造体を登録します。
HRESULT SetProviderUID(
LPMAPIUID lpProviderID,
ULONG ulFlags
);
パラメーター
lpProviderID
[in]アドレス帳またはメッセージ ストア プロバイダーを識別する MAPIUID 構造体へのポインター。
ulFlags
予約;は 0 にする必要があります。
戻り値
S_OK
MAPIUID 構造体が正常に登録されました。
注釈
IMAPISupport::SetProviderUID メソッドは、アドレス帳とメッセージ ストア プロバイダーのサポート オブジェクトに実装されます。 これらのプロバイダーは SetProviderUID を呼び出して、lpProviderID によって指されている MAPIUID 構造体で説明されている一意の識別子を登録します。 プロバイダーは、作成するすべてのエントリ識別子にこの識別子を含めます。
MAPI は、MAPI スプーラーに送信メッセージを送信するときに MAPIUID 構造体を使用し、クライアント要求を処理するための適切なプロバイダーを決定します。 たとえば、クライアントが IMAPISession::OpenEntry メソッドを呼び出すと、MAPI はエントリ識別子の MAPIUID 部分を調べ、 それを SetProviderUID に渡したプロバイダーにマップし、そのプロバイダーの OpenEntry を呼び出します。
呼び出し側への注意
ログオン時に SetProviderUID を呼び出して、MAPIUID 構造体を登録します。 MAPI を使用すると、アドレス帳とメッセージ ストア プロバイダーが複数の識別子を登録できます。 SetProviderUID を複数呼び出すと、MAPIUID が重複している場合でも、プロバイダーの MAPIUID 構造体セットに MAPIUID 構造体が常に追加されます。 SetProviderUID は MAPIUID を削除できません。