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 |
|---|---|
|
검색된 작업 수는 요청된 수와 같습니다. |
|
반환된 숫자가 요청된 수보다 작습니다. (따라서 열거할 작업이 더 이상 없습니다.) |
|
매개 변수가 잘못되었습니다. |
|
사용 가능한 메모리가 부족합니다. |
설명
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 이상 |