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 |
|---|---|
|
액세스가 거부되었습니다. 호출자가 Administrators 그룹의 구성원이 아닌 경우 이 오류가 반환됩니다. pwszAccount 매개 변수가 로컬 시스템 계정이 아닌 명명된 계정을 나타내는 NULL이 아니고 pwszAccount 매개 변수에 지정된 계정에 대해 pwszPassword 매개 변수가 올바르지 않은 경우에도 이 오류가 반환됩니다. |
|
데이터가 잘못되었습니다. pwszPassword 매개 변수가 NULL이거나 pwszPassword 매개 변수 문자열의 길이가 너무 긴 경우 이 오류가 반환됩니다. |
|
지정된 계정의 존재를 설정할 수 없습니다. pwszAccount 매개 변수가 로컬 시스템 계정이 아닌 명명된 계정을 나타내는 NULL이 아니고 pwszAccount 매개 변수를 찾을 수 없는 경우 이 오류가 반환됩니다. |
설명
SetNetScheduleAccountInformation은 호출자를 가장합니다. 일정 계정 정보가 설정되는 컴퓨터의 로컬 관리자 그룹의 구성원만 이 함수를 성공적으로 실행할 수 있습니다. NULL 암호는 허용되지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista, WINDOWS XP SP1 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | atacct.h |
| 라이브러리 | Mstask.lib |
| DLL | Mstask.dll |