次の方法で共有

LAUNCHWIZARDENTRY

  • [アーティクル]

適用対象: 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 プロトタイプに基づいてプロバイダーのコールバック関数を呼び出します。

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