LAUNCHWIZARDENTRY

[アーティクル]
04/04/2023

適用対象: Outlook 2013 | Outlook 2016

プロファイルに 1 つ以上のメッセージサービスを追加する目的で、プロファイルウィザードアプリケーションを起動する関数を定義します。

プロパティ	値
ヘッダーファイル:	Mapiwz.h
によって実装される定義された関数:	MAPI
によって呼び出される定義済み関数:	クライアントアプリケーション

HRESULT LAUNCHWIZARDENTRY(
  HWND hParentWnd,
  ULONG ulFlags,
  LPCSTR FAR * lppszServiceNameToAdd,
  ULONG cbBufferMax,
  LPSTR lpszNewProfileName
);

パラメーター

hParentWnd

[in]呼び出し元の親ウィンドウへのハンドル。呼び出し元に親ウィンドウがない場合、 hParentWnd パラメーターは NULL にする必要があります。

ulFlags

[in]プロファイルウィザードのオプションを示すフラグのビットマスク。次のフラグを設定できます。

MAPI_PW_ADD_SERVICE_ONLY

プロファイルウィザードでは、 lppszServiceNameToAdd パラメーターを使用して一覧表示されているメッセージサービスのみを追加し、メッセージサービスを選択するためのページは表示しません。

MAPI_PW_FIRST_PROFILE

作成するプロファイルは、このワークステーションの最初のプロファイルです。

MAPI_PW_HIDE_SERVICES_LIST

メッセージサービスを選択するためのプロファイルウィザードのページを表示しないでください。

MAPI_PW_LAUNCHED_BY_CONFIG

プロファイルウィザードは、コントロールパネル構成アプリケーションによって起動されました。

MAPI_PW_PROVIDER_UI_ONLY

サービスプロバイダーの構成ダイアログボックスのみが表示され、プロファイルウィザードのページは表示されません。このフラグは、MAPI_PW_ADD_SERVICE_ONLY フラグが設定されている場合にのみ設定できます。

lppszServiceNameToAdd

[in]プロファイルに追加するメッセージサービスの名前を含む文字列の配列へのポインター。配列は NULL 値で終了する必要があります。

cbBufferMax

[in] lpszNewProfileName パラメーターによって指されるバッファーのサイズ。

lpszNewProfileName

[out] LAUNCHWIZARDENTRY に基づく関数が作成されたプロファイルの名前を返す文字列バッファーへのポインター。

戻り値

S_OK

�ʘb��A�\��l�܂��͒l��Ԃ��܂��B

MAPI_E_CALL_FAILED

予期しない、または不明な配信元のエラーにより、操作が完了できませんでした。プロファイルウィザードの MAPI サブシステムを初期化できない、既定のプロファイルにアクセスできない、ダイアログボックスからエラーが返されるなど、可能性があります。

注釈

LAUNCHWIZARDENTRY 関数プロトタイプの MAPI 実装は、MAPI プロファイルウィザードアプリケーションへのエントリポイントです。 MAPI には、このエントリポイント LaunchWizard という名前が付けられます。

ulFlags パラメーターで MAPI_PW_ADD_SERVICE_ONLY フラグを設定すると、次の規則が適用されます。

MAPI_PW_LAUNCHED_BY_CONFIG フラグは、ウェルカムページの表示を禁止します。
MAPI_PW_HIDE_SERVICES_LISTフラグとMAPI_PW_PROVIDER_UI_ONLY フラグは、既定のプロファイルがない場合にのみ役立ちます。この場合、これらのフラグによって、表示するプロファイルウィザードページが決まります。
既定のプロファイルが存在する場合、プロファイルウィザードのページは表示されません。
既定のプロファイルが存在する場合、 lppszServiceNameToAdd パラメーターを介して 1 つのメッセージサービスのみが一覧表示され、そのメッセージサービスが既定のプロファイルに既に存在する場合、プロファイルウィザードはプロファイルに何も追加せずにS_OKを返します。

プロファイルに追加するすべてのメッセージサービスについて、プロファイルウィザードは MSGSERVICEENTRY プロトタイプに基づいてサービスのエントリポイント関数を呼び出します。プロファイルに追加するメッセージサービスから選択されたサービスプロバイダーごとに、プロファイルウィザードは WIZARDENTRY プロトタイプに基づいてプロバイダーのエントリポイント関数を呼び出します。対話型構成時に、プロパティページ内のすべてのユーザーイベントによって、プロファイルウィザードは SERVICEWIZARDDLGPROC プロトタイプに基づいてプロバイダーのコールバック関数を呼び出します。

プロファイルに追加するサービスプロバイダーがプロファイルウィザードページをサポートしている場合は、プロファイルのプログラムによる構成を許可する必要があります。

LAUNCHWIZARDENTRY

パラメーター

戻り値

注釈

その他のリソース