Funzione PeerGroupEnumMembers (p2p.h)
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 |
---|---|
|
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 |
---|---|
|
Uno dei parametri non è valido. |
|
Memoria insufficiente per eseguire l'operazione specificata. |
|
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 |