Funzione PeerGroupEnumMembers (p2p.h)

Articolo
03/05/2024

La funzione PeerGroupEnumMembers crea un'enumerazione dei membri del gruppo peer disponibili e delle informazioni di appartenenza associate.

Sintassi

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

Parametri

[in] hGroup

Gestire il gruppo peer i cui membri sono enumerati. Questo handle viene restituito dalla funzione PeerGroupCreate, PeerGroupOpen o PeerGroupJoin . Questo parametro è obbligatorio.

[in] dwFlags

Specifica i flag di PEER_MEMBER_FLAGS che indicano quali tipi di membri includere nell'enumerazione. Se questo valore è impostato su zero, vengono inclusi tutti i membri del gruppo di peer.

Valore	Significato
PEER_MEMBER_PRESENT	Enumera tutti i membri del gruppo peer corrente online.

[in] pwzIdentity

Stringa Unicode contenente l'identità di un peer specifico le cui informazioni vengono recuperate e restituite in un'enumerazione a un unico elemento. Se questo parametro è NULL, vengono recuperati tutti i membri del gruppo di peer corrente. Questo parametro è obbligatorio.

[out] phPeerEnum

Puntatore all'enumerazione contenente l'elenco restituito di membri del gruppo peer. Questo handle viene passato a
PeerGetNextItem per recuperare gli elementi, con ogni elemento rappresentato come puntatore a una struttura PEER_MEMBER . 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.

Commenti

Il nodo locale è sempre il primo elemento dell'enumerazione se pwzIdentity è NULL e dwFlags è impostato per indicare che il nodo locale è un membro del subset esplicito.

Per impostazione predefinita, ogni membro pubblica le informazioni di appartenenza al gruppo peer. Se PEER_MEMBER_DATA_OPTIONAL è impostato sui dati di PEER_MEMBER per tale peer, queste informazioni sono disponibili solo quando un peer esegue un'azione all'interno del gruppo, ad esempio la pubblicazione di un record, l'aggiornamento della presenza o l'emissione di un GMC.

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

Vedi anche

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem

Condividi tramite