PeerGraphGetNextItem 함수(p2p.h)

아티클
08/25/2023

PeerGraphGetNextItem 함수는 피어 열거형 핸들을 반환하는 다음 함수를 호출하여 만든 열거형의 다음 항목 또는 항목을 가져옵니다.

구문

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetNextItem(
  [in]      HPEERENUM hPeerEnum,
  [in, out] ULONG     *pCount,
  [out]     PVOID     **pppvItems
);

매개 변수

[in] hPeerEnum

열거형에 대한 핸들입니다.

[in, out] pCount

입력은 가져올 항목 수를 지정합니다.

출력은 가져온 실제 항목 수를 받습니다.

참고pCount 가 0 출력인 경우 열거형의 끝에 도달합니다.

[out] pppvItems

요청된 항목에 대한 포인터 배열을 받습니다. 배열에 포함된 포인터 수는 pCount의 출력 값으로 지정됩니다. 반환되는 실제 데이터는 열거형 유형에 따라 달라집니다. 반환되는 구조체 유형은 PEER_CONNECTION_INFO, PEER_NODE_INFO 및 PEER_RECORD

반환 값

함수 호출이 성공하면 반환 값이 S_OK. 그렇지 않으면 다음 값 중 하나를 반환합니다.

반환 코드	설명
E_INVALIDARG	하나의 매개 변수가 잘못되었습니다.
E_OUTOFMEMORY	지정된 작업을 수행하기에 충분한 메모리가 없습니다.
PEER_E_NOT_INITIALIZED	이 함수를 사용하기 전에 PeerGraphStartup 을 호출하여 그래프를 초기화해야 합니다.

설명

데이터가 더 이상 필요하지 않을 때 PeerGraphFreeData를 호출하여 ppvItems를 해제합니다.

애플리케이션은 가져올 항목의 범위를 요청할 수 있습니다. 함수는 pCount 이하의 항목을 반환합니다.

예제

다음 코드 조각에서는 PeerGraphGetNextItem 을 사용하여 개체를 열거하고 열거형 처리를 완료한 후 열거형을 종료하는 방법을 보여 주는 코드 조각입니다.

//PeerGraphGetNextItem snippet
    // hPeerEnum is a handle to the enumeration obtained from a successful call to PeerGraphEnumConnections,
    // PeerGraphEnumNodes, PeerGraphEnumRecords, or PeerGraphSearchRecords.
    // Set count equal to the maximum number of items you want returned. To obtain a count of all the items
    // in the enumeration, call PeerGraphGetItemCount.
    // ppRecord is an array of pointers to PEER_RECORD objects.  PEER_CONNECTION_INFO and PEER_NODE_INFO structures
    // are also supported.
    HRESULT hr = PeerGraphGetNextItem(hPeerEnum, &count, (PVOID *)&ppRecord);
    if (FAILED(hr))
    {
        // Insert your code to handle the error here.
    }
    else
    {
        // Free the data obtained by PeerGraphGetNextItem.
        PeerGraphFreeData(ppRecord);
    }

    // If you are done with the enumeration, free the handle to the enumeration.
    PeerGraphEndEnumeration(hPeerEnum);

요구 사항

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