IProfAdmin::AdminServices

適用於:Outlook 2013 |Outlook 2016

提供訊息服務管理物件的存取權,以便對配置檔中的訊息服務進行變更。

HRESULT AdminServices(
  LPSTR lpszProfileName,
  LPSTR lpszPassword,
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  LPSERVICEADMIN FAR * lppServiceAdmin
);

參數

lpszProfileName

[in]要修改之配置檔名稱的指標。 lpszProfileName 參數不得為 NULL。

lpszPassword

[in]一律為 NULL。

ulUIParam

[in]這個方法所顯示之任何對話框或視窗的父視窗句柄。

ulFlags

[in]控制擷取訊息服務管理對象的旗標位掩碼。 您可以設定下列旗標:

MAPI_DIALOG

啟用使用者介面的顯示。

MAPI_UNICODE

配置檔名稱是 Unicode 格式。 如果未設定MAPI_UNICODE旗標,則名稱會是 ANSI 格式。

lppServiceAdmin

[out]訊息服務管理物件指標的指標。

傳回值

S_OK

已成功傳回訊息服務管理物件。

MAPI_E_LOGON_FAILED

指定的配置檔不存在,或密碼錯誤,而且無法向用戶顯示對話框來要求正確的密碼,因為未在 ulFlags 中設定MAPI_DIALOG。

MAPI_E_USER_CANCEL

使用者已取消作業,通常是按兩下對話框中的 [ 取消 ] 按鈕。

註解

IProfAdmin::AdminServices 方法可讓您存取訊息服務管理物件,以便對配置檔中的訊息服務進行組態變更。

lpszPassword 參數必須是 NULL 或零長度字串的指標。

呼叫者注意事項

雖然您可以呼叫此方法或 IMAPISession::AdminServices 來擷取 IMsgServiceAdmin 指標,但如果您有嚴格的設定用戶端且不提供傳訊功能,請呼叫 IProfAdmin::AdminServicesIProfAdmin::AdminServices 不會建立會話物件,也不會載入任何可增強效能的服務提供者。

您無法使用 IProfAdmin::AdminServices 來建立配置檔。 因此,您必須在 lpszProfileName 中指定現有的有效配置檔。 如果指定的配置檔不存在, IProfAdmin::AdminServices 會 傳回MAPI_E_LOGON_FAILED。

設定檔的名稱長度最多可以是 64 個字元,而且可以包含下列字元:

  • 所有英數位元,包括輔色字元和底線字元。

  • 內嵌空格,但不是前置或尾端空格。

MFCMAPI 參考

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

檔案 Function Comment
MAPIProfileFunctions.cpp
HrAddServiceToProfile
MFCMAPI 會使用 IProfAdmin::AdminServices 方法,為選取的配置文件開啟訊息服務管理物件以新增服務。

另請參閱

IMAPISession::AdminServices

IProfAdmin:IUnknown

MFCMAPI 作為程式碼範例