適用於: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::AdminServices。 IProfAdmin::AdminServices 不會建立會話物件,也不會載入任何可增強效能的服務提供者。
您無法使用 IProfAdmin::AdminServices 來建立配置檔。 因此,您必須在 lpszProfileName 中指定現有的有效配置檔。 如果指定的配置檔不存在, IProfAdmin::AdminServices 會 傳回MAPI_E_LOGON_FAILED。
設定檔的名稱長度最多可以是 64 個字元,而且可以包含下列字元:
所有英數位元,包括輔色字元和底線字元。
內嵌空格,但不是前置或尾端空格。
MFCMAPI 參考
如需 MFCMAPI 範例程式代碼,請參閱下表。
| 檔案 | Function | Comment |
|---|---|---|
| MAPIProfileFunctions.cpp |
HrAddServiceToProfile |
MFCMAPI 會使用 IProfAdmin::AdminServices 方法,為選取的配置文件開啟訊息服務管理物件以新增服務。 |