Funzione PeerEnumIdentities (p2p.h)
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 |
|---|---|
|
Uno dei parametri non è valido. |
|
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 |