다음을 통해 공유


ITaskFolder::RegisterTask 메서드(taskschd.h)

XML을 사용하여 폴더에 새 작업을 등록(생성)하여 작업을 정의합니다.

통사론

HRESULT RegisterTask(
  [in]           BSTR            path,
  [in]           BSTR            xmlText,
  [in]           LONG            flags,
  [in]           VARIANT         userId,
  [in]           VARIANT         password,
  [in]           TASK_LOGON_TYPE logonType,
  [in, optional] VARIANT         sddl,
  [out]          IRegisteredTask **ppTask
);

매개 변수

[in] path

작업 이름입니다. 이 값이 NULL작업이 루트 작업 폴더에 등록되고 작업 이름은 작업 스케줄러 서비스에서 만든 GUID 값이 됩니다.

작업 이름은 공백 문자로 시작하거나 끝낼 수 없습니다. '.' 문자를 사용하여 현재 작업 폴더와 '.'을 지정할 수 없습니다. 문자는 경로에서 부모 작업 폴더를 지정하는 데 사용할 수 없습니다.

[in] xmlText

작업의 XML 형식 정의입니다.

다음 항목에는 XML을 사용하여 정의된 작업이 포함되어 있습니다.

[in] flags

TASK_CREATION 상수입니다.

의미
TASK_VALIDATE_ONLY
0x1
작업 스케줄러는 작업을 설명하지만 작업을 등록하지 않는 XML 구문을 확인합니다. 이 상수는 TASK_CREATE, TASK_UPDATE또는 TASK_CREATE_OR_UPDATE 값과 결합할 수 없습니다.
TASK_CREATE
0x2
작업 스케줄러는 작업을 새 작업으로 등록합니다.
TASK_UPDATE
0x4
작업 스케줄러는 작업을 기존 작업의 업데이트된 버전으로 등록합니다. 등록 트리거가 있는 작업이 업데이트되면 업데이트가 발생한 후 작업이 실행됩니다.
TASK_CREATE_OR_UPDATE
0x6
작업 스케줄러는 작업을 새 작업으로 등록하거나 작업이 이미 있는 경우 업데이트된 버전으로 등록합니다. TASK_CREATE 동일 | TASK_UPDATE.
TASK_DISABLE
0x8
작업 스케줄러는 기존 작업을 사용하지 않도록 설정합니다.
TASK_DONT_ADD_PRINCIPAL_ACE
0x10
작업 스케줄러는 컨텍스트 보안 주체에 대한 ACE(액세스 제어 허용 항목)를 추가할 수 없습니다. 작업을 업데이트하기 위해 이 플래그로 ITaskFolder::RegisterTask 함수를 호출하면 작업 스케줄러 서비스는 새 컨텍스트 보안 주체에 대한 ACE를 추가하지 않고 이전 컨텍스트 보안 주체에서 ACE를 제거하지 않습니다.
TASK_IGNORE_REGISTRATION_TRIGGERS
0x20
작업 스케줄러는 작업을 만들지만 태스크의 등록 트리거는 무시합니다. 등록 트리거를 무시하면 시간 기반 트리거로 인해 등록 시 작업이 실행되지 않는 한 작업이 등록될 때 실행되지 않습니다.

[in] userId

작업을 등록하는 데 사용되는 사용자 자격 증명입니다.

참고 작업이 작업 스케줄러 1.0 작업으로 정의된 경우 이 userId 매개 변수에서 그룹 이름(특정 사용자 이름 대신)을 사용하지 마세요. 태스크는 작업 XML에 있는 Task 요소의 버전 특성이 1.1로 설정된 경우 작업 스케줄러 1.0 작업으로 정의됩니다.
 

[in] password

작업을 등록하는 데 사용되는 userId의 암호입니다. TASK_LOGON_SERVICE_ACCOUNT 로그온 유형을 사용하는 경우 암호는 VT_NULL 또는 VT_EMPTY같은 VARIANT 값이 비어 있어야 합니다.

[in] logonType

등록된 작업을 실행하는 데 사용되는 로그온 기술을 정의하는 값입니다.

의미
TASK_LOGON_NONE
0
로그온 메서드가 지정되지 않았습니다. NT가 아닌 자격 증명에 사용됩니다.
TASK_LOGON_PASSWORD
1
사용자에 대한 로깅에 암호를 사용합니다. 암호는 등록 시 제공해야 합니다.
TASK_LOGON_S4U
2
기존 대화형 토큰을 사용하여 작업을 실행합니다. 사용자는 S4U(사용자용 서비스) 로그온을 사용하여 로그온해야 합니다. S4U 로그온을 사용하는 경우 시스템에서 암호를 저장하지 않으며 네트워크 또는 암호화된 파일에 액세스할 수 없습니다.
TASK_LOGON_INTERACTIVE_TOKEN
3
사용자가 이미 로그온되어 있어야 합니다. 작업은 기존 대화형 세션에서만 실행됩니다.
TASK_LOGON_GROUP
4
그룹 활성화. groupId 필드는 그룹을 지정합니다.
TASK_LOGON_SERVICE_ACCOUNT
5
로컬 시스템, 로컬 서비스 또는 네트워크 서비스 계정이 작업을 실행하는 보안 컨텍스트로 사용됨을 나타냅니다.
TASK_LOGON_INTERACTIVE_TOKEN_OR_PASSWORD
6
먼저 대화형 토큰을 사용합니다. 사용자가 로그온하지 않은 경우(대화형 토큰을 사용할 수 없음) 암호가 사용됩니다. 태스크를 등록할 때 암호를 지정해야 합니다. 이 플래그는 TASK_LOGON_PASSWORD보다 신뢰성이 떨어지므로 새 작업에는 권장되지 않습니다.

[in, optional] sddl

등록된 작업과 연결된 보안 설명자입니다. 작업에 대한 특정 사용자 및 그룹 액세스를 허용하거나 거부하기 위해 작업에 대한 보안 설명자에서 ACL(액세스 제어 목록)을 지정할 수 있습니다.

참고 로컬 시스템 계정에 작업에 대한 액세스가 거부되면 작업 스케줄러 서비스가 예기치 않은 결과를 생성할 수 있습니다.
 

[out] ppTask

새 작업을 나타내는 IRegisteredTask 인터페이스입니다.

NULLIRegisteredTask 인터페이스 포인터에 대한 참조를 전달합니다. NULL 포인터를 참조하면 포인터를 덮어쓰기 때문에 메모리 누수가 발생할 수 있습니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드/값 묘사
S_OK
0x0
작업이 성공적으로 완료되었습니다.
E_ACCESS_DENIED
0x80070005
작업 스케줄러 서비스에 연결하기 위해 액세스가 거부되었습니다.
E_OUTOFMEMORY
0x8007000e
애플리케이션에는 작업을 완료하기에 충분한 메모리가 없거나 사용자 또는 암호 null 값이 하나 이상 있고 null이 아닌 값이 하나 이상 있습니다.
SCHED_S_BATCH_LOGON_PROBLEM
0x0004131C
작업이 등록되었지만 시작에 실패할 수 있습니다. 작업 주체에 대해 일괄 로그온 권한을 사용하도록 설정해야 합니다.
SCHED_S_SOME_TRIGGERS_FAILED
0x0004131B
작업이 등록되었지만 지정된 모든 트리거가 작업을 시작하지는 않습니다.

발언

메시지 상자 작업이 포함된 작업의 경우 작업이 활성화되고 작업에 대화형 로그온 유형이 있는 경우 메시지 상자가 표시됩니다. 작업 로그온 유형을 대화형으로 설정하려면 작업 주체의 LogonType 속성 또는 ITaskFolder::RegisterTask 또는 ITaskFolder::RegisterTaskDefinitionlogonType 매개 변수에서 TASK_LOGON_INTERACTIVE_TOKEN 또는 TASK_LOGON_GROUP 지정합니다.

관리자 그룹의 구성원만 부팅 트리거를 사용하여 작업을 만들 수 있습니다.

userId 매개 변수 TASK_LOGON_INTERACTIVE_TOKEN에 지정된 그룹과 ITaskFolder::RegisterTask 또는 ITaskFolder::RegisterTaskDefinitionlogonType 매개 변수에 지정된 그룹에 작업을 성공적으로 등록할 수 있지만 작업이 실행되지 않습니다.

TASK_VALIDATE_ONLY 및 TASK_IGNORE_REGISTRATION_TRIGGERS 값을 플래그 매개 변수에 함께 전달하는 것은 잘못된 인수입니다.

태스크가 작업의 NetworkSettings 설정에 없는 네트워크를 정의하는 경우 ITaskFolder::RegisterTask 메서드는 작업이 등록될 때 오류 0x8000ffff 반환합니다.

요구 사항

요구
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 taskschd.h
라이브러리 Taskschd.lib
DLL Taskschd.dll

참고 항목

IRegisteredTask

ITaskFolder

작업 스케줄러