IProfAdmin::AdminServices

適用対象: Outlook 2013 | Outlook 2016

プロファイル内のメッセージ サービスを変更するためのメッセージ サービス管理オブジェクトへのアクセスを提供します。

HRESULT AdminServices(
  LPSTR lpszProfileName,
  LPSTR lpszPassword,
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  LPSERVICEADMIN FAR * lppServiceAdmin
);

パラメーター

lpszProfileName

[in]変更するプロファイルの名前へのポインター。 lpszProfileName パラメーターは NULL にすることはできません。

lpszPassword

[in]Always NULL。

ulUIParam

[in]このメソッドが表示するダイアログ ボックスまたはウィンドウの親ウィンドウのハンドル。

ulFlags

[in]メッセージ サービス管理オブジェクトの取得を制御するフラグのビットマスク。 次のフラグを設定できます。

MAPI_DIALOG

ユーザー インターフェイスの表示を有効にします。

MAPI_UNICODE

プロファイル名は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、名前は ANSI 形式です。

lppServiceAdmin

[out]メッセージ サービス管理オブジェクトへのポインター。

戻り値

S_OK

メッセージ サービス管理オブジェクトが正常に返されました。

MAPI_E_LOGON_FAILED

指定したプロファイルが存在しないか、パスワードが間違っており、 ulFlags でMAPI_DIALOGが設定されていないため、ユーザーに正しいパスワードを要求するダイアログ ボックスを表示できませんでした。

MAPI_E_USER_CANCEL

ユーザーは通常、ダイアログ ボックスの [キャンセル] ボタンをクリックして操作を 取り消 しました。

注釈

IProfAdmin::AdminServices メソッドは、プロファイル内のメッセージ サービスに構成を変更するためのメッセージ サービス管理オブジェクトへのアクセスを提供します。

lpszPassword パラメーターは NULL または長さ 0 の文字列へのポインターである必要があります。

呼び出し側への注意

IMsgServiceAdmin ポインターは、このメソッドまたは IMAPISession::AdminServices を呼び出すことで取得できますが、厳密に構成クライアントがあり、メッセージング機能がない場合は IProfAdmin::AdminServices を呼び出します。 IProfAdmin::AdminServices はセッション オブジェクトを作成せず、サービス プロバイダーを読み込まないため、パフォーマンスが向上します。

IProfAdmin::AdminServices を使用してプロファイルを作成することはできません。 そのため、 lpszProfileName に既存の有効なプロファイルを指定する必要があります。 指定したプロファイルが存在しない場合、 IProfAdmin::AdminServices は MAPI_E_LOGON_FAILEDを返します。

プロファイルの名前の長さは最大 64 文字で、次の文字を含めることができます。

  • アクセント文字とアンダースコア文字を含むすべての英数字。

  • 埋め込みスペースですが、先頭または末尾のスペースではありません。

MFCMAPI リファレンス

MFCMAPI のサンプル コードについては、次の表を参照してください。

ファイル 関数 コメント
MAPIProfileFunctions.cpp
HrAddServiceToProfile
MFCMAPI では 、IProfAdmin::AdminServices メソッドを使用して、選択したプロファイルのメッセージ サービス管理オブジェクトを開いてサービスを追加します。

関連項目

IMAPISession::AdminServices

IProfAdmin : IUnknown

[�R��h �T���v���Ƃ��� MFCMAPI