Función PeerEnumGroups (p2p.h)
La función PeerEnumGroups crea y devuelve un identificador de enumeración del mismo nivel que se usa para enumerar todos los grupos del mismo nivel asociados a una identidad del mismo nivel específica.
Sintaxis
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumGroups(
[in] PCWSTR pwzIdentity,
[out] HPEERENUM *phPeerEnum
);
Parámetros
[in] pwzIdentity
Especifica la identidad del mismo nivel para la que se van a enumerar los grupos.
[out] phPeerEnum
Recibe un identificador de la enumeración del mismo nivel que contiene la lista de grupos del mismo nivel de los que la identidad especificada es miembro, con cada elemento representado como puntero a una estructura de PEER_NAME_PAIR . Pase este identificador a PeerGetNextItem para recuperar los elementos; cuando termine, llame a PeerEndEnumeration para liberar la memoria.
Valor devuelto
Si la llamada de función se realiza correctamente, el valor devuelto es S_OK. De lo contrario, devuelve uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
Uno de los parámetros no es válido. |
|
No hay suficiente memoria para realizar la operación especificada. |
|
No se encuentra la identidad del mismo nivel especificada. |
Comentarios
Una vez que la aplicación haya obtenido el identificador de enumeración, use PeerGetNextItem y PeerGetItemCount para enumerar los grupos del mismo nivel.
Al enumerar grupos del mismo nivel, PeerGetNextItem devuelve una matriz de punteros a PEER_NAME_PAIR estructuras.
Llame a PeerEndEnumeration para liberar el identificador de enumeración del mismo nivel cuando ya no sea necesario.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack para Windows XP |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | p2p.h |
| Library | P2P.lib |
| Archivo DLL | P2P.dll |