Compartilhar via


Função PeerGraphGetItemCount (p2p.h)

A função PeerGraphGetItemCount recupera o número de itens em uma enumeração.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetItemCount(
  [in]  HPEERENUM hPeerEnum,
  [out] ULONG     *pCount
);

Parâmetros

[in] hPeerEnum

Identificador para um grafo par.

[out] pCount

Recebe um ponteiro para o número de registros em uma enumeração.

Valor retornado

Se a chamada de função for bem-sucedida, o valor retornado será S_OK. Caso contrário, ele retornará o valor a seguir.

Código de retorno Descrição
E_INVALIDARG
Um parâmetro não é válido.
E_OUTOFMEMORY
Não há memória suficiente para executar uma operação especificada.
PEER_E_NOT_INITIALIZED
Um grafo par deve ser inicializado com uma chamada para PeerGraphStartup antes de usar essa função.

Comentários

Como alguns itens podem se tornar inválidos enquanto um aplicativo está enumerando um conjunto de itens, o número de itens retornados de PeerGraphGetNextItem pode ser menor do que o número de itens retornados em pCount. O valor de pCount indica o número de itens em uma enumeração quando o identificador é criado. Devido à natureza dinâmica da Infraestrutura de Pares, não é garantido que o número de itens recuperados usando PeerGraphGetNextItem seja igual a pCount.

Requisitos

   
Cliente mínimo com suporte Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho p2p.h
Biblioteca P2PGraph.lib
DLL P2PGraph.dll

Confira também

PeerGraphEndEnumeration

PeerGraphGetNextItem