WIZARDENTRY

適用於:Outlook 2013 |Outlook 2016

定義「配置檔精靈」呼叫的服務提供者進入點函式,以擷取足夠的資訊來顯示提供者的組態屬性表。

屬性
標頭檔:
Mapiwz.h
定義函式實作者:
服務提供者
由下列項目呼叫的定義函式:
MAPI 設定檔精靈
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專案中。

資源名稱是將在 [配置檔精靈] 窗格中呈現之對話框資源的名稱。 傳回的資源必須包含單一對話框資源中的所有頁面。 當 [配置檔精靈] 收到此資源時,它會忽略對話框樣式,但不會忽略控件樣式,並建立所有控件作為 [配置檔精靈] 頁面的子系。 一開始會隱藏所有控制件。 提供者應該確定其控件的座標是以零或零為基底,而且不會超過 200 個對話單元的最大寬度和 150 個對話單位的最大高度。 低於 400 的控件識別碼會保留給配置檔精靈。 配置檔精靈會在提供者的使用者介面上方以粗體文字顯示提供者的標題。

提供者應該保留 lpMAPIProp 參數中提供的屬性介面指標,以供日後參考。 配置檔精靈只會處理最基本的一組屬性,而且提供者可以使用屬性介面實作來包含其他屬性。 在設定期間,提供者應該將其組態屬性新增至實作屬性介面的物件。 設定所有提供者之後,配置檔精靈會將這些屬性新增至配置檔。

如需如何使用此函式的詳細資訊,請參閱 支援訊息服務組態