IEnumConnections::Next 메서드(ocidl.h)
열거형 시퀀스에서 지정된 수의 항목을 검색합니다.
구문
HRESULT Next(
[in] ULONG cConnections,
[out] LPCONNECTDATA rgcd,
[out] ULONG *pcFetched
);
매개 변수
[in] cConnections
검색할 항목 수입니다. 시퀀스에 남아 있는 요청된 항목 수보다 적은 경우 이 메서드는 나머지 요소를 검색합니다.
[out] rgcd
열거된 항목의 배열입니다.
열거자는 메모리를 할당해야 하며 호출자는 메모리를 해제할 책임이 있습니다. celt가 1보다 큰 경우 호출자는 해제할 포인터 수를 알기 위해 pceltFetched에 전달된 NULL이 아닌 포인터도 전달해야 합니다.
[out] pcFetched
검색된 항목 수입니다. 이 매개 변수는 항상 요청된 항목 수보다 작거나 같습니다.
반환 값
메서드가 요청된 항목 수를 검색하면 반환 값이 S_OK. 그렇지 않으면 S_FALSE.
설명
이 메서드가 성공적으로 반환되면 호출자는 배열의 각 요소에 대해 Release(CONNECTDATA의 pUnk 멤버 참조)를 호출합니다. cConnections가 1보다 큰 경우 호출자는 해제해야 하는 포인터 수를 가져오기 위해 nULL이 아닌 포인터를 lpcFetched에 전달해야 합니다.
E_NOTIMPL 반환 값으로 허용되지 않습니다. 오류 값이 반환되면 배열의 항목이 종료될 때 유효하지 않으므로 릴리스가 필요하지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | ocidl.h(ObjIdl.h 포함) |