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の値は、アカウント名とパスワードが正常に設定されたことを示します。 その他の値は、エラー状態を示します。
関数が失敗した場合、可能な戻り値の一部を以下に示します。
リターン コード/値 | 説明 |
---|---|
|
アクセスが拒否されました。 呼び出し元が Administrators グループのメンバーではなかった場合、このエラーが返されます。 このエラーは、pwszAccount パラメーターが NULL でなく、名前付きアカウントがローカル システム アカウントでないことを示し、pwszAccount パラメーターで指定されたアカウントに対して pwszPassword パラメーターが正しくない場合にも返されます。 |
|
データが無効です。 pwszPassword パラメーターが NULL であるか、pwszPassword パラメーター文字列の長さが長すぎる場合、このエラーが返されます。 |
|
指定されたアカウントの存在を確立できません。 pwszAccount パラメーターが NULL でなく、名前付きアカウントがローカル システム アカウントではなく、pwszAccount パラメーターが見つからなかったことを示す場合、このエラーが返されます。 |
注釈
SetNetScheduleAccountInformation は呼び出し元を偽装します。 スケジュール アカウント情報が設定されているコンピューター上のローカル Administrators グループのメンバーのみが、この関数を正常に実行できます。 NULL パスワードは許可されないことに注意してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista、SP1 を使用した Windows XP [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | atacct.h |
Library | Mstask.lib |
[DLL] | Mstask.dll |