適用於：Outlook 2013 |Outlook 2016
定義啟動設定檔精靈應用程式的函式，以便將一或多個訊息服務新增至配置檔。
| 屬性 | 值 |
|---|---|
| 標頭檔： |
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
呼叫成功，並傳回預期的值。
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 參數列出，而且該訊息服務已經在預設配置檔中，配置檔精靈會傳回S_OK，而不會將任何專案新增至配置檔。
針對要新增至配置檔的每個訊息服務，配置檔精靈會根據 MSGSERVICEENTRY 原型呼叫服務的進入點函式。 針對從訊息服務中選取要新增至配置檔的每個服務提供者，配置檔精靈會根據 WIZARDENTRY 原型呼叫提供者的進入點函式。 在互動式設定期間，屬性頁中的每個使用者事件都會使配置檔精靈根據 SERVICEWIZARDDLGPROC 原型呼叫提供者的回呼函式。
如果新增至配置檔的服務提供者支援 [配置檔精靈] 頁面，則必須允許以程式設計方式設定配置檔。