IMsgServiceAdmin::AdminProviders

適用於:Outlook 2013 |Outlook 2016

傳回指標,提供提供者系統管理物件的存取權。

HRESULT AdminProviders(
  LPMAPIUID lpUID,
  ULONG ulFlags,
  LPPROVIDERADMIN FAR * lppProviderAdmin
);

參數

lpUID

[in] MAPIUID 結構的指標,其中包含要管理之訊息服務的唯一標識符。

ulFlags

[in]一律為 NULL。

lppProviderAdmin

[out]提供者管理物件指標的指標。

傳回值

S_OK

已成功傳回提供者管理物件。

MAPI_E_NOT_FOUND

lpUID 所指向的 MAPIUID 不存在。

註解

IMsgServiceAdmin::AdminProviders 方法提供提供者系統管理物件的存取權。 提供者管理是支援 IProviderAdmin 介面的物件,可讓客戶端執行下列動作:

  • 將服務提供者新增至訊息服務。

  • 從訊息服務刪除服務提供者。

  • 開啟配置檔區段。

  • 存取訊息服務提供者數據表。

配置檔正在使用時,可以實際對訊息服務進行的變更類型取決於訊息服務。 不過,大部分的訊息服務都不支持變更,例如在使用配置檔時新增和刪除提供者。

呼叫者注意事項

若要擷取要管理之訊息服務的 MAPIUID 結構,請從訊息服務數據表中的訊息 服務數據列 擷取 PR_SERVICE_UID (PidTagServiceUid) 屬性數據行。 如需詳細資訊,請參閱 IMsgServiceAdmin::CreateMsgService 方法中所述的程式。

MFCMAPI 參考

如需 MFCMAPI 範例程式代碼,請參閱下表。

檔案 Function Comment
MsgServiceTableDlg.cpp
CMsgServiceTableDlg::OnDisplayItem
MFCMAPI 使用 IMsgServiceAdmin::AdminProviders 方法來開啟服務的提供者管理物件。

另請參閱

IProviderAdmin:IUnknown

MAPIUID

IMsgServiceAdmin:IUnknown

MFCMAPI 作為程式碼範例