Funzione PeerGraphEnumNodes (p2p.h)
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 |
---|---|
|
Un parametro non è valido. |
|
Memoria insufficiente per eseguire un'operazione specificata. |
|
L'handle di un grafo peer non è valido. |
|
Prima di usare questa funzione, è necessario inizializzare un grafo peer con una chiamata a PeerGraphStartup . |
|
Un grafo peer non è completamente sincronizzato e i nodi non possono essere enumerati. |
|
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 |