次の方法で共有


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 を呼び出す必要があります。

関連項目

IMAPISupport::DoConfigPropsheet

PidTagResourceMethods 標準プロパティ

IMAPIStatus : IMAPIProp