Funzione PeerEnumIdentities (p2p.h)

Articolo
03/01/2024

La funzione PeerEnumIdentities crea e restituisce un handle di enumerazione peer usato per enumerare tutte le identità peer che appartengono a un utente specifico.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumIdentities(
  [out] HPEERENUM *phPeerEnum
);

Parametri

[out] phPeerEnum

Riceve un handle per l'enumerazione peer che contiene l'elenco di identità peer, 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 per rilasciare la memoria.

Valore restituito

Se la 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	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione specificata.

Commenti

Dopo aver ottenuto l'handle di enumerazione peer, usare PeerGetNextItem e PeerGetItemCount per enumerare le identità peer.

Durante l'enumerazione delle identità peer, PeerGetNextItem restituisce una matrice di puntatori per PEER_NAME_PAIR strutture.

Chiamare PeerEndEnumeration per liberare l'handle di enumerazione 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