SetNetScheduleAccountInformation 函式 (atacct.h)

[SetNetScheduleAccountInformation 已不再可供 Windows 8 使用。請改用工作排程器 2.0 介面。

]

SetNetScheduleAccountInformation 函式會設定 AT 服務帳戶名稱和密碼。 AT 服務帳戶名稱和密碼會作為使用 NetScheduleJobAdd 建立之排程作業的認證。

語法

HRESULT SetNetScheduleAccountInformation(
  [in] LPCWSTR pwszServerName,
  [in] LPCWSTR pwszAccount,
  [in] LPCWSTR pwszPassword
);

[in] pwszServerName

要設定帳戶資訊之計算機名稱的NULL終止寬字元字串。

[in] pwszAccount

帳戶之 NULL 終止寬字元字串的指標。若要指定本機系統帳戶，請將此參數設定為 NULL。

[in] pwszPassword

密碼之 NULL 終止寬字元字串的指標。如需保護密碼資訊的相關信息，請參閱處理密碼。

傳回值為 HRESULT。 S_OK值表示已成功設定帳戶名稱和密碼。任何其他值都表示錯誤狀況。

如果函式失敗，以下列出一些可能的傳回值。

傳回碼/值	Description
E_ACCESSDENIED 0x080070005	拒絕存取。如果呼叫端不是 Administrators 群組的成員，就會傳回此錯誤。如果 pwszAccount 參數不是 NULL ，表示具名帳戶不是本機系統帳戶，且 pwszPassword 參數對於 pwszAccount 參數中指定的帳戶不正確，也會傳回此錯誤。
HRESULT_FROM_WIN32 (ERROR_INVALID_DATA) 0x08007000d	資料無效。如果 pwszPassword 參數為 NULL 或 pwszPassword 參數位符串的長度太長，就會傳回此錯誤。
SCHED_E_ACCOUNT_NAME_NOT_FOUND 0x80041310	無法建立指定的帳戶存在。如果 pwszAccount 參數不是 NULL ，表示沒有本機系統帳戶且找不到 pwszAccount 參數的具名帳戶，就會傳回此錯誤。

SetNetScheduleAccountInformation 會模擬呼叫端。只有設定排程帳戶資訊之計算機上的本機 Administrators 群組成員可以順利執行此函式。請注意，不允許 NULL 密碼。

需求	值
最低支援的用戶端	Windows Vista、Windows XP 與 SP1 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	atacct.h
程式庫	Mstask.lib
Dll	Mstask.dll