Função PeerGraphEnumNodes (p2p.h)
A função PeerGraphEnumNodes cria e retorna um identificador de enumeração usado para enumerar os nós em um grafo par. A enumeração fornece uma instantâneo de um grafo par no momento em que uma enumeração é executada. Dependendo da política de um grafo par e se os nós não publicarem informações de presença, uma enumeração não retornará alguns nós conectados a um grafo par.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumNodes(
[in] HGRAPH hGraph,
[in] PCWSTR pwzPeerId,
[out] HPEERENUM *phPeerEnum
);
Parâmetros
[in] hGraph
Identificador para um grafo par.
[in] pwzPeerId
A ID do par para obter uma enumeração de nó. Especifique NULL para retornar todos os nós em um grafo par.
[out] phPeerEnum
Recebe um identificador para uma enumeração. Use PeerGraphGetNextItem para recuperar as informações reais do nó. Quando esse identificador não for necessário, libere-o chamando PeerGraphEndEnumeration.
Retornar valor
Se uma chamada de função for bem-sucedida, o valor retornado será S_OK. Caso contrário, ele retornará um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
Um parâmetro não é válido. |
|
Não há memória suficiente para executar uma operação especificada. |
|
O identificador para um grafo par é inválido. |
|
Um grafo par deve ser inicializado com uma chamada para PeerGraphStartup antes de usar essa função. |
|
Um grafo par não é sincronizado completamente e os nós não podem ser enumerados. |
|
Um grafo par não requer informações de presença. Portanto, os nós não podem ser enumerados. |
Comentários
Se PeerGraphGetNextItem for chamado com o identificador que PeerGraphEnumNodes retorna, PeerGraphGetNextItem retornará os dados na estrutura PEER_NODE_INFO .
Requisitos
| Requisito | Valor |
|---|---|
| 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 |