PeerGetNextItem 함수(p2p.h)
PeerGetNextItem 함수는 피어 열거형에서 특정 개수의 항목을 반환합니다.
구문
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGetNextItem(
[in] HPEERENUM hPeerEnum,
[in, out] ULONG *pCount,
[out] PVOID **pppvItems
);
매개 변수
[in] hPeerEnum
항목이 검색되는 피어 열거형에 대한 핸들입니다. 이 핸들은 피어 열거형 함수에 의해 생성됩니다.
[in, out] pCount
피어 열거형에서 검색할 항목 수를 지정하는 정수에 대한 포인터입니다. 반환되면 ppvItems의 항목 수가 포함됩니다. 이 매개 변수는 NULL일 수 없습니다.
[out] pppvItems
피어 열거형의 다음 pCount 항목에 대한 포인터 배열에 대한 포인터를 받습니다. 레코드 또는 멤버 정보 블록과 같은 데이터는 실제 피어 열거형 형식에 따라 달라집니다.
반환 값
작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 함수는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
매개 변수 중 하나가 잘못되었습니다. |
|
지정된 작업을 수행하기에 충분한 메모리가 없습니다. |
설명
PeerGetNextItem 함수는 다음을 반환합니다.
- pCount에 지정된 양과 같거나 작은 항목입니다.
- 금액이 사용 가능한 항목 수보다 클 때 지정된 양보다 작은 항목 목록입니다.
참고 예를 들어 pCount 의 인바운드 값이 10이고 열거형의 나머지가 5개 항목인 경우 5개 항목만 반환되고 pCount 에서 가리키는 값은 5로 설정됩니다.
열거형의 끝은 함수가 pCount 매개 변수가 0으로 설정된 상태에서 반환될 때 표시됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | WINDOWS XP SP2 [데스크톱 앱만 해당],Windows XP SP1 및 고급 네트워킹 팩 forWindows XP |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | p2p.h |
| 라이브러리 | P2P.lib |
| DLL | P2P.dll |