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 を削除できません。

関連項目

MAPIUID

IMAPISupport: IUnknown