IMAPIStatus::SettingsDialog
適用対象: Outlook 2013 | Outlook 2016
ユーザーがサービス プロバイダーの構成を変更できるようにするプロパティ シートを表示します。このメソッドは、MAPI が実装する状態オブジェクトではサポートされていません。
HRESULT SettingsDialog(
ULONG_PTR ulUIParam,
ULONG ulFlags
);
パラメーター
ulUIParam
[in]構成プロパティ シートの親ウィンドウへのハンドル。
ulFlags
[in]プロパティ シートの表示を制御するフラグのビットマスク。 次のフラグを設定できます。
UI_READONLY
プロバイダーがユーザーが構成プロパティを変更できるようにしないことを提案します。 このフラグは単に提案です。無視できます。
戻り値
S_OK
構成プロパティ シートが正常に表示されました。
MAPI_E_NO_SUPPORT
status オブジェクトは、 PR_RESOURCE_METHODS (PidTagResourceMethods) プロパティに STATUS_SETTINGS_DIALOG フラグが存在しないことで示されているように、このメソッドをサポートしていません。
注釈
IMAPIStatus::SettingsDialog メソッドには、構成プロパティ シートが表示されます。 すべてのサービス プロバイダーは SettingsDialog メソッドをサポートする必要がありますが、必須ではありません。 サービス プロバイダーは、独自のプロパティ シートを実装することも、サポート オブジェクトの IMAPISupport::D oConfigPropsheet メソッドで提供されている実装を使用することもできます。 DoConfigPropsheet は 、読み取り/書き込みプロパティ シートを作成します。
実装に関するメモ
リモート トランスポート プロバイダーに設定がある場合は、次の操作を行う必要があります。
トランスポート プロバイダーのプロファイル セクションを開きます。
プロファイルからトランスポート プロバイダーのプロパティ設定を取得します。
ダイアログ ボックスにプロパティ設定を表示します。
ダイアログ ボックスでプロパティ設定の編集が許可されている場合は、新しい設定が有効であることをチェックし、トランスポート プロバイダーのプロファイル セクションに保存します。
S_OK、または前の手順で返されたエラー値を返します。
呼び出し側への注意
SettingsDialog に表示されるプロパティ シートを使用して、次のようなさまざまなタスクを実行できます。
既定のメッセージ ストアを指定します。
トランスポート注文を指定します。
参照する既定のアドレス帳コンテナーを指定します。
あいまいな名前を解決するための検索順序を指定します。
既定の個人用アドレス帳を指定します。
サービス プロバイダーは、プロパティに応じて、読み取り/書き込み、読み取り専用、またはアクセス許可の組み合わせであるプロパティ シートを実装できます。 サービス プロバイダーは、プロパティ制限を設定することで、個々のプロパティに対して異なるアクセス許可を実装できます。 プロパティ シートの既定のモードは、読み取り/書き込みです。 SettingsDialog の呼び出しでUI_READONLY フラグを設定することで、読み取り専用プロパティ シートを要求できます。 読み取り専用プロパティ シートを実装できるサービス プロバイダーは、これを行うことができます。 ただし、一部のサービス プロバイダーは既定のモードをオーバーライドできないため、どちらの型のプロパティ シートも処理するように準備する必要があります。
ユーザー インターフェイスは常にこの操作に関与するため、対話型クライアントのみが SettingsDialog を呼び出す必要があります。