Funzione PeerGraphEnumNodes (p2p.h)

Articolo
03/15/2023

La funzione PeerGraphEnumNodes crea e restituisce un handle di enumerazione usato per enumerare i nodi in un grafo peer. L'enumerazione fornisce uno snapshot di un grafico peer al momento dell'esecuzione di un'enumerazione. A seconda dei criteri di un grafo peer e se i nodi non pubblicano informazioni sulla presenza, un'enumerazione non restituisce alcuni nodi connessi a un grafo peer.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumNodes(
  [in]  HGRAPH    hGraph,
  [in]  PCWSTR    pwzPeerId,
  [out] HPEERENUM *phPeerEnum
);

Parametri

[in] hGraph

Gestire in un grafo peer.

[in] pwzPeerId

ID peer per ottenere un'enumerazione del nodo. Specificare NULL per restituire tutti i nodi in un grafo peer.

[out] phPeerEnum

Riceve un handle per un'enumerazione. Usare PeerGraphGetNextItem per recuperare le informazioni effettive sul nodo. Quando questo handle non è necessario, liberarlo chiamando PeerGraphEndEnumeration.

Valore restituito

Se una chiamata di funzione ha esito positivo, il valore restituito viene S_OK. In caso contrario, restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Un parametro non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire un'operazione specificata.
PEER_E_INVALID_GRAPH	L'handle di un grafo peer non è valido.
PEER_E_NOT_INITIALIZED	Prima di usare questa funzione, è necessario inizializzare un grafo peer con una chiamata a PeerGraphStartup .
PEER_E_NOT_READY	Un grafo peer non è completamente sincronizzato e i nodi non possono essere enumerati.
PEER_E_PRESENCE_DISABLED	Un grafo peer non richiede informazioni sulla presenza. Pertanto, non è possibile enumerare i nodi.

Commenti

Se PeerGraphGetNextItem viene chiamato con l'handle restituito da PeerGraphEnumNodes , PeerGraphGetNextItem restituisce i dati nella struttura PEER_NODE_INFO .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop],Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2PGraph.lib
DLL	P2PGraph.dll

Vedi anche

PEER_NODE_INFO

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem

Condividi tramite