IEnumWorkItems::Next 메서드(mstask.h)

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

열거형 시퀀스에서 지정한 다음 개수의 작업을 검색합니다.

시퀀스에 남아 있는 요청된 작업 수보다 적은 경우 나머지 모든 요소가 검색됩니다.

구문

HRESULT Next(
  [in]  ULONG  celt,
  [out] LPWSTR **rgpwszNames,
  [out] ULONG  *pceltFetched
);

[in] celt

검색할 작업 수입니다.

[out] rgpwszNames

열거형 시퀀스에서 반환된 작업의 파일 이름을 포함하는 null로 끝나는 문자열에 대한 포인터 배열(LPWSTR)에 대한 포인터입니다. 이러한 파일 이름은 예약된 작업 폴더 에서 가져와서 ".job" 확장명을 갖습니다.

rgpwszNames에서 반환된 이름을 처리한 후에는 먼저 배열의 각 문자열을 해제한 다음, CoTaskMemFree를 사용하여 배열 자체를 해제해야 합니다.

[out] pceltFetched

rgpwszNames에서 반환된 작업 수에 대한 포인터입니다. celt 매개 변수가 1이면 이 매개 변수는 NULL일 수 있습니다.

다음 값 중 하나를 반환합니다.

반환 코드	Description
S_OK	검색된 작업 수는 요청된 수와 같습니다.
S_FALSE	반환된 숫자가 요청된 수보다 작습니다. (따라서 열거할 작업이 더 이상 없습니다.)
E_INVALIDARG	매개 변수가 잘못되었습니다.
E_OUTOFMEMORY	사용 가능한 메모리가 부족합니다.

IEnumWorkItems 인터페이스는 열거형을 다시 설정, 작업을 건너뛰고 열거형의 현재 상태 복사본을 만드는 메서드도 제공합니다.

Next를 사용하여 예약된 작업 폴더의 작업을 열거하는 방법에 대한 예제는 작업 열거 예제를 참조하세요.

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