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 メソッドを使用して、選択したプロファイルのメッセージ サービス管理オブジェクトを開いてサービスを追加します。 |