IProfAdmin::DeleteProfile
適用対象: Outlook 2013 | Outlook 2016
プロファイルを削除します。
HRESULT DeleteProfile(
LPSTR lpszProfileName,
ULONG ulFlags
);
パラメーター
lpszProfileName
[in]削除するプロファイルの名前へのポインター。
ulFlags
[in]プロファイルの削除方法を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_APP_PROFILE
"アプリ" プロファイルの削除を許可します。 削除するプロファイルが "アプリ" プロファイルの場合は、このフラグを設定する必要があります。
このフラグは、すべての MAPI 実装で認識またはサポートされていない可能性があります。
戻り値
S_OK
プロファイルが正常に削除されました。
MAPI_E_NO_ACCESS
プロファイルは "アプリ" プロファイルであり、MAPI_APP_PROFILE フラグが設定されていません。
MAPI_E_NOT_FOUND
指定したプロファイルが存在しません。
解説
IProfAdmin::D eleteProfile メソッドはプロファイルを削除します。 DeleteProfile が呼び出されたときに削除するプロファイルが使用されている場合、DeleteProfile はS_OKを返しますが、プロファイルはすぐには削除しません。 代わりに、 DeleteProfile はプロファイルを削除対象としてマークし、使用されなくなった後、アクティブなセッションがすべて終了したときに削除します。
プロファイル内の各メッセージ サービスのエントリ ポイント関数は、 ulContext パラメーターにMSG_SERVICE_DELETE値を設定して呼び出されます。 最初に、関数はサービスを削除し、次にサービスのプロファイル セクションを削除します。 メッセージ サービス エントリ ポイント関数は、サービスが削除された後に再び呼び出されません。
プロファイルを削除するためにパスワードは必要ありません。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| MAPIProfileFunctions.cpp |
HrRemoveProfile |
MFCMAPI では、 IProfAdmin::D eleteProfile メソッドを使用して、選択したプロファイルを削除します。 |