IMsgServiceAdmin::AdminProviders
適用対象: Outlook 2013 | Outlook 2016
プロバイダー管理オブジェクトへのアクセスを提供するポインターを返します。
HRESULT AdminProviders(
LPMAPIUID lpUID,
ULONG ulFlags,
LPPROVIDERADMIN FAR * lppProviderAdmin
);
パラメーター
lpUID
[in]管理するメッセージ サービスの一意識別子を含む MAPIUID 構造体へのポインター。
ulFlags
[in]Always NULL。
lppProviderAdmin
[out]プロバイダー管理オブジェクトへのポインター。
戻り値
S_OK
プロバイダー管理オブジェクトが正常に返されました。
MAPI_E_NOT_FOUND
lpUID が指す MAPIUID が存在しません。
注釈
IMsgServiceAdmin::AdminProviders メソッドは、プロバイダー管理オブジェクトへのアクセスを提供します。 プロバイダー管理は、 IProviderAdmin インターフェイスをサポートし、クライアントが次のことを行うことを可能にするオブジェクトです。
サービス プロバイダーをメッセージ サービスに追加します。
メッセージ サービスからサービス プロバイダーを削除します。
プロファイル セクションを開きます。
メッセージ サービス プロバイダー テーブルにアクセスします。
プロファイルの使用中にメッセージ サービスに対して実際に行うことができる変更の種類は、メッセージ サービスによって異なります。 ただし、ほとんどのメッセージ サービスでは、プロファイルが使用中のプロバイダーの追加や削除などの変更はサポートされていません。
呼び出し側への注意
管理するメッセージ サービスの MAPIUID 構造体を取得するには、メッセージ サービス テーブルのメッセージ サービスの行から PR_SERVICE_UID (PidTagServiceUid) プロパティ列を取得します。 詳細については、 IMsgServiceAdmin::CreateMsgService メソッドで説明されている手順を参照してください。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| MsgServiceTableDlg.cpp |
CMsgServiceTableDlg::OnDisplayItem |
MFCMAPI では、 IMsgServiceAdmin::AdminProviders メソッドを使用して、サービスのプロバイダー管理オブジェクトを開きます。 |