Funzione PeerGroupEnumConnections (p2p.h)

Articolo
03/15/2023

La funzione PeerGroupEnumConnections crea un'enumerazione delle connessioni attualmente attive nel peer.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupEnumConnections(
  [in]  HGROUP    hGroup,
  [in]  DWORD     dwFlags,
  [out] HPEERENUM *phPeerEnum
);

Parametri

[in] hGroup

Handle al gruppo che contiene le connessioni da enumerare. Questo handle viene restituito dalla funzione PeerGroupCreate, PeerGroupOpen o PeerGroupJoin . Questo parametro è obbligatorio.

[in] dwFlags

Specifica i flag che indicano il tipo di connessione da enumerare. I valori validi vengono specificati da PEER_CONNECTION_FLAGS.

[out] phPeerEnum

Puntatore all'enumerazione contenente l'elenco restituito di connessioni attive. Questo handle viene passato a
PeerGetNextItem per recuperare gli elementi, con ogni elemento rappresentato come puntatore a una struttura PEER_CONNECTION_INFO . Al termine, PeerEndEnumeration viene chiamato per restituire la memoria usata dall'enumerazione. Questo parametro è obbligatorio.

Valore restituito

Restituisce S_OK se l'operazione ha esito positivo. In caso contrario, la funzione 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_INVALID_GROUP	L'handle al gruppo di peer non è valido.

Gli errori specifici della crittografia possono essere restituiti dal provider di base Microsoft RSA. Questi errori sono preceduti da CRYPT_* e definiti in Winerror.h.

Requisiti


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	P2P.lib
DLL	P2P.dll

Vedi anche

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem

Condividi tramite