IEnumProgressItems::RemoteNext 메서드
열거형 시퀀스에서 지정된 수의 항목을 검색하려는 원격 클라이언트를 지원합니다.
구문
HRESULT RemoteNext(
[in] ULONG celt,
[out] IProgressItem **rgelt,
[out] ULONG *pceltFetched
);
매개 변수
-
celt [in]
-
검색할 항목 수입니다.
-
rgelt [out]
-
IProgressItem 인터페이스의 배열입니다. 완료되면 rgelt에서 각 인터페이스를 해제해야 합니다.
-
pceltFetched [out]
-
rgelt에서 반환된 요소 수입니다. celt가 하나인 경우 pceltFetched를 NULL로 설정할 수 있습니다. 그렇지 않으면 이 메서드를 호출하기 전에 pceltFetched 값을 0으로 초기화합니다.
반환 값
요청된 요소 수(셀트)가 성공적으로 반환되거나 반환된 항목 수(pceltFetched)가 요청된 요소 수보다 작으면 S_OK 반환됩니다.
구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 유일한 오류 값은 나타내지 않습니다.
| 반환 코드 | 설명 |
|---|---|
|
포인터가 잘못되었습니다. 값: 0x80004003 |
|
필요한 메모리를 할당하지 못했습니다. 값: 0x8007000E |
|
하나 이상의 인수가 잘못되었습니다. 값: 0x80070057 |
|
예기치 않은 오류가 발생했습니다. 값: 0x8000FFFF |
설명
시퀀스에 남아 있는 요청된 요소 수보다 적은 수의 요소가 있으면 나머지 요소를 검색합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| IDL |
|