Funzione PeerEnumGroups (p2p.h)

Articolo
03/01/2024

La funzione PeerEnumGroups crea e restituisce un handle di enumerazione peer usato per enumerare tutti i gruppi di peer associati a un'identità peer specifica.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumGroups(
  [in]  PCWSTR    pwzIdentity,
  [out] HPEERENUM *phPeerEnum
);

Parametri

[in] pwzIdentity

Specifica l'identità peer per enumerare i gruppi.

[out] phPeerEnum

Riceve un handle per l'enumerazione peer che contiene l'elenco dei gruppi peer di cui l'identità specificata è membro, con ogni elemento rappresentato come puntatore a una struttura PEER_NAME_PAIR . Passare questo handle a PeerGetNextItem per recuperare gli elementi; al termine, chiamare PeerEndEnumeration rilasciare la memoria.

Valore restituito

Se la chiamata alla funzione ha esito positivo, il valore restituito è S_OK. In caso contrario, restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione specificata.
PEER_E_NOT_FOUND	Impossibile trovare l'identità peer specificata.

Commenti

Dopo aver ottenuto l'handle di enumerazione, usare PeerGetNextItem e PeerGetItemCount per enumerare i gruppi di peer.

Durante l'enumerazione dei gruppi di peer, PeerGetNextItem restituisce una matrice di puntatori alle strutture PEER_NAME_PAIR .

Chiamare PeerEndEnumeration per liberare l'handle di enumerazione peer quando non è più necessario.

Requisiti

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

Vedi anche

Condividi tramite