Share via

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の値は、アカウント名とパスワードが正常に設定されたことを示します。 その他の値は、エラー状態を示します。

関数が失敗した場合、可能な戻り値の一部を以下に示します。

リターン コード/値 説明
E_ACCESSDENIED
0x080070005
 アクセスが拒否されました。 呼び出し元が Administrators グループのメンバーではなかった場合、このエラーが返されます。 このエラーは、pwszAccount パラメーターが NULL でなく、名前付きアカウントがローカル システム アカウントでないことを示し、pwszAccount パラメーターで指定されたアカウントに対して pwszPassword パラメーターが正しくない場合にも返されます。
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、SP1 を使用した Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー atacct.h
Library Mstask.lib
[DLL] Mstask.dll

こちらもご覧ください

GetNetScheduleAccountInformation