WIZARDENTRY

適用対象: Outlook 2013 | Outlook 2016

プロファイル ウィザードがプロバイダーの構成プロパティ シートを表示するのに十分な情報を取得するために呼び出すサービス プロバイダーエントリ ポイント関数を定義します。

ULONG WIZARDENTRY(
  HINSTANCE hProviderDLLInstance,
  LPSTR FAR * lpcsResourceName,
  DLGPROC FAR * lppDlgProc,
  LPMAPIPROP lpMAPIProp,
  LPMAPISUPPORTOBJECT lpMapiSupportObject
);

パラメーター

hProviderDLLInstance

[in]サービス プロバイダーの DLL のインスタンス ハンドル。

lpcsResourceName

[out]構成中にプロファイル ウィザードによって表示されるダイアログ リソースの完全な名前を含む文字列へのポインター。 NULL ターミネータを含む文字列の最大サイズは 32 文字です。

lppDlgProc

[out]さまざまなイベントをプロバイダーに通知するためにプロファイル ウィザードによって呼び出される標準の Windows ダイアログ ボックス プロシージャへのポインター。

lpMAPIProp

[in]構成プロパティへのアクセスを提供するプロパティ インターフェイス実装へのポインター。

lpMapiSupportObject

[in]このセッションに適用できる MAPI サポート オブジェクトへのポインター。

戻り値

S_OK

サービス プロバイダーの WIZARDENTRY 関数が正常に呼び出されました。

MAPI_E_CALL_FAILED

予期しない、または不明な配信元のエラーにより、操作が完了できませんでした。

注釈

プロファイル ウィザードは、サービス プロバイダーの構成ユーザー インターフェイスを表示する準備ができたら 、WIZARDENTRY ベースの関数を呼び出します。 プロファイル ウィザードは、すべてのプロバイダーの構成が完了すると、 IMsgServiceAdmin::ConfigureMsgService を呼び出すことによって構成プロパティをプロファイルに書き込みます。

実装に関するメモ

WIZARDENTRY ベースの関数の名前は、MAPISVC.INF のWIZARD_ENTRY_NAME エントリに配置する必要があります。

リソース名は、プロファイル ウィザードのウィンドウに表示されるダイアログ リソースの名前です。 返されるリソースには、1 つのダイアログ リソース内のすべてのページを含める必要があります。 プロファイル ウィザードは、このリソースを受け取ると、ダイアログ スタイルは無視されますが、コントロール スタイルは無視され、すべてのコントロールが [プロファイル ウィザード] ページの子として作成されます。 最初は、すべてのコントロールが非表示になります。 プロバイダーは、コントロールの座標が 0 または 0 から始まるかどうか、および最大幅が 200 ダイアログ 単位、最大高さが 150 ダイアログ 単位を超えないようにする必要があります。 400 未満のコントロール識別子は、プロファイル ウィザード用に予約されています。 プロファイル ウィザードでは、プロバイダーのユーザー インターフェイスの上に、プロバイダーのタイトルが太字で表示されます。

lpMAPIProp パラメーターで指定されたプロパティ インターフェイス ポインターは、今後の参照のためにプロバイダーによって保持される必要があります。 プロファイル ウィザードでは、最も基本的なプロパティ セットのみが処理され、プロバイダーはプロパティ インターフェイスの実装を使用して追加のプロパティを含めることができます。 構成中に、プロバイダーは、プロパティ インターフェイスを実装するオブジェクトに構成プロパティを追加する必要があります。 すべてのプロバイダーが構成されると、プロファイル ウィザードによってこれらのプロパティがプロファイルに追加されます。

この関数の使用方法の詳細については、「 メッセージ サービスの構成のサポート」を参照してください。