IProviderAdmin::CreateProvider

適用於: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 參數中的值也會傳遞至進入點函式。 這些額外的參數可讓服務提供者顯示其屬性表,讓使用者可以輸入組態設定。

另請參閱