IScheduledWorkItem::GetRunTimes 메서드(mstask.h)

  • 아티클

[[이 API는 운영 체제 또는 제품의 후속 버전에서 변경되거나 사용할 수 없을 수 있습니다. 대신 작업 스케줄러 2.0 인터페이스를 사용하세요.] ]

지정된 기간 동안 작업 항목 실행 시간을 검색합니다.

구문

HRESULT GetRunTimes(
  [in]      const LPSYSTEMTIME pstBegin,
  [in]      const LPSYSTEMTIME pstEnd,
  [in, out] WORD               *pCount,
  [out]     LPSYSTEMTIME       *rgstTaskTimes
);

매개 변수

[in] pstBegin

검사 기간의 시작 시간을 포함하는 SYSTEMTIME 구조체에 대한 포인터입니다. 해당 값이 포함되어 있습니다.

[in] pstEnd

검사 기간의 종료 시간을 포함하는 SYSTEMTIME 구조체에 대한 포인터입니다. 이 값은 배타적입니다. 이 값에 대해 NULL 이 전달되면 종료 시간은 무한합니다.

[in, out] pCount

검색할 실행 횟수를 지정하는 WORD 값에 대한 포인터입니다.

입력 시 이 매개 변수에는 요청되는 런타임 수가 포함됩니다. 1에서 TASK_MAX_RUN_TIMES 사이의 숫자일 수 있습니다.

출력에서 이 매개 변수에는 검색된 실행 시간 수가 포함됩니다.

[out] rgstTaskTimes

SYSTEMTIME 구조체 배열에 대한 포인터입니다. NULL LPSYSTEMTIME 개체를 이 매개 변수에 전달해야 합니다. 반환 시 이 배열에는 pCount 런타임이 포함됩니다. CoTaskMemFree 함수를 호출하여 이 배열을 해제해야 합니다.

반환 값

GetRunTimes 메서드는 다음 값 중 하나를 반환합니다.

반환 코드 Description
S_OK
 요청된 실행 시간 수가 검색되었습니다.
S_FALSE
 메서드가 성공했지만 요청된 실행 시간보다 적습니다. 검색된 런타임 수는 pCount에서 가리키는 값에 포함됩니다. 검색된 실행 시간 수가 0이면 지정된 기간 동안 작업 항목을 실행할 수 있는 이벤트 기반 트리거도 없습니다.
SCHED_S_TASK_NO_VALID_TRIGGERS
 작업 항목이 활성화되어 있지만 유효한 트리거가 없습니다.
SCHED_S_TASK_DISABLED
 작업 항목을 사용할 수 없습니다.
E_INVALIDARG
 하나 이상의 인수가 잘못되었습니다.
E_OUTOFMEMORY
 결과를 계산할 메모리가 부족합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 mstask.h
라이브러리 Mstask.lib
DLL Mstask.dll
재배포 가능 파일 Windows NT 4.0 및 Windows 95에서 인터넷 Explorer 4.0 이상

추가 정보

IScheduledWorkItem