適用於:Outlook 2013 |Outlook 2016
將服務提供者新增至訊息服務。
HRESULT CreateProvider(
LPSTR lpszProvider,
ULONG cValues,
LPSPropValue lpProps,
ULONG_PTR ulUIParam,
ULONG ulFlags,
MAPIUID FAR * lpUID
);
參數
lpszProvider
[in]要加入之提供者名稱的指標。
cValues
[in] lpProps 參數所指向的屬性值計數。
lpProps
[in]屬性值陣列的指標,描述要加入之提供者的屬性。
ulUIParam
[in]這個方法所顯示之任何對話框或視窗之父視窗的句柄。 如果在ulFlags參數中設定MAPI_DIALOG旗標,則會使用ulUIParam參數。
ulFlags
[in]控制提供者加法的旗標位掩碼。 您可以設定下列旗標:
MAPI_DIALOG:顯示對話框以提示您輸入設定資訊。
MAPI_UNICODE:提供者名稱和字串屬性是 Unicode 格式。 如果未設定MAPI_UNICODE旗標,則這些字串為 ANSI 格式。
lpUID
[out] MAPIUID 結構的指標,其中包含代表要加入之提供者的唯一標識符。
傳回值
S_OK
提供者已成功新增至訊息服務。
MAPI_E_USER_CANCEL
使用者已取消作業,通常是按兩下對話框中的 [ 取消 ] 按鈕。
註解
IProviderAdmin::CreateProvider 方法會將服務提供者新增至訊息服務。 lpszProvider 參數必須指向屬於訊息服務的提供者名稱。 CreateProvider 不會驗證名稱是否符合服務中的提供者名稱;如果傳遞的名稱不符合服務名稱,則呼叫會成功,但結果無法預測。 大部分的訊息服務不允許在配置檔使用時新增或刪除提供者。
從 Mapisvc.inf 檔案將服務提供者的所有可用資訊新增至配置檔之後, CreateProvider 會呼叫訊息服務的進入點函式,並將 ulContext 參數設定為 MSG_SERVICE_PROVIDER_CREATE。 如果在 CreateProvider 方法的 ulFlags 參數中設定MAPI_DIALOG,ulUIParam 和 ulFlags 參數中的值也會傳遞至進入點函式。 這些額外的參數可讓服務提供者顯示其屬性表,讓使用者可以輸入組態設定。