IRegisteredTask::GetInstances 메서드(taskschd.h)

  • 아티클

현재 실행 중인 등록된 작업의 모든 인스턴스를 반환합니다.

참고IRegisteredTask::GetInstances 사용자의 보안 컨텍스트에서 실행 중인 현재 실행 중인 등록된 작업의 인스턴스만 반환합니다. 예를 들어 Administrators 그룹 구성원의 경우 GetInstances 현재 실행 중인 등록된 작업의 모든 인스턴스를 반환하지만 사용자 그룹의 구성원에 대해 GetInstances 사용자 그룹 보안 컨텍스트에서 실행 중인 현재 실행 중인 등록된 작업의 인스턴스만 반환합니다.

 

통사론

HRESULT GetInstances(
        LONG                   flags,
  [out] IRunningTaskCollection **ppRunningTasks
);

매개 변수

flags

이 매개 변수는 나중에 사용하도록 예약되어 있으며 0으로 설정해야 합니다.

[out] ppRunningTasks

사용자의 컨텍스트에서 현재 실행 중인 작업의 모든 인스턴스를 포함하는 IRunningTaskCollection 인터페이스입니다.

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

반환 값

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

반환 코드 묘사
S_OK
 작업이 성공적으로 완료되었습니다.
E_INVALIDARG
 null이 아닌 플래그가 플래그 매개 변수에 전달되었습니다.
E_POINTER
 NULL이 ppRunningTasks 매개 변수로 전달되었습니다.

요구 사항

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

참고 항목

IRegisteredTask

IRunningTaskCollection

작업 스케줄러