IProfAdmin::CreateProfile
適用対象: Outlook 2013 | Outlook 2016
新しいプロファイルを作成します。
HRESULT CreateProfile(
LPSTR lpszProfileName,
LPSTR lpszPassword,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
パラメーター
lpszProfileName
[in]新しいプロファイルの名前へのポインター。
lpszPassword
[in]新しいプロファイルのパスワードへのポインター。
ulUIParam
[in]このメソッドが表示するダイアログ ボックスまたはウィンドウの親ウィンドウへのハンドル。
ulFlags
[in]プロファイルの作成方法を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_APP_PROFILE
MAPI では、検出可能性と操作を制限する "アプリ" プロファイルとしてこのプロファイルを作成する必要があります。
このフラグは、すべての MAPI 実装で認識またはサポートされていない可能性があります。
MAPI_DEFAULT_SERVICES
MAPI は、Mapisvc.inf ファイルの [既定のサービス] セクションに含まれているメッセージ サービスを新しいプロファイルに設定する必要があります。
MAPI_DIALOG
追加するメッセージ サービス内の各プロバイダーの構成プロパティ シートを表示できます。
戻り値
S_OK
新しいプロファイルが作成されました。
MAPI_E_NO_ACCESS
指定した新しいプロファイルが既に存在します。
解説
IProfAdmin::CreateProfile メソッドは、新しいプロファイルを作成します。
呼び出し側への注意
CreateProfile は、アプリケーションのインストール時またはセッション中にいつでも呼び出すことができます。 このメソッドがインストール時に呼び出されると、構成設定の多くは Mapisvc.inf 構成ファイルから取得されます。 アクティブなセッション中にこのメソッドを呼び出すと、設定は、一連のプロパティ シートを介してプロンプトが表示されるユーザーから取得されます。
MAPI_DEFAULT_SERVICES フラグが ulFlags パラメーターに設定されている場合、 CreateProfile は Mapisvc.inf ファイルの [既定のサービス] セクションの各メッセージ サービスのメッセージ サービス エントリ ポイント関数を呼び出します。 各メッセージ サービス エントリ ポイント関数は、 ulContext パラメーターを MSG_SERVICE_CREATE に設定して呼び出されます。
MAPI_DIALOGフラグとMAPI_DEFAULT_SERVICESフラグの両方が設定されている場合、 ulUIParam パラメーターと ulFlags パラメーターの値もメッセージ サービス エントリ ポイント関数に渡されます。 メッセージ サービス エントリ ポイント関数は、Mapisvc.inf ファイルから使用可能なすべての情報がプロファイルに追加された後にのみ呼び出されます。
新しいプロファイルの名前とそのパスワードの長さは最大 64 文字で、次の文字を含めることができます。
アクセント文字とアンダースコア文字を含むすべての英数字。
埋め込みスペースですが、先頭または末尾のスペースではありません。
lpszPassword パラメーターは NULL または長さ 0 の文字列へのポインターである必要があります。
関連項目
IMsgServiceAdmin::ConfigureMsgService