PeerGetNextItem 함수(p2p.h)

아티클
03/05/2024

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 반환합니다. 그렇지 않으면 함수는 다음 값 중 하나를 반환합니다.

반환 코드	설명
E_INVALIDARG	매개 변수 중 하나가 잘못되었습니다.
E_OUTOFMEMORY	지정된 작업을 수행하기에 충분한 메모리가 없습니다.

설명

PeerGetNextItem 함수는 다음을 반환합니다.

pCount에 지정된 양과 같거나 작은 항목입니다.
금액이 사용 가능한 항목 수보다 클 때 지정된 양보다 작은 항목 목록입니다.

참고 예를 들어 pCount 의 인바운드 값이 10이고 열거형의 나머지가 5개 항목인 경우 5개 항목만 반환되고 pCount 에서 가리키는 값은 5로 설정됩니다.

반환된 모든 항목은 포인터 배열에 대한 포인터를 PeerFreeData 함수에 전달하여 해제해야 합니다.

열거형의 끝은 함수가 pCount 매개 변수가 0으로 설정된 상태에서 반환될 때 표시됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2 [데스크톱 앱만 해당],Windows XP SP1 및 고급 네트워킹 팩 forWindows XP
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	p2p.h
라이브러리	P2P.lib
DLL	P2P.dll