Función PeerCollabEnumApplications (p2p.h)
La función PeerCollabEnumApplications devuelve el identificador a una enumeración que contiene las aplicaciones registradas en los puntos de conexión de un mismo nivel específicos.
Sintaxis
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplications(
[in, optional] PCPEER_ENDPOINT pcEndpoint,
[in, optional] const GUID *pApplicationId,
[out] HPEERENUM *phPeerEnum
);
Parámetros
[in, optional] pcEndpoint
Puntero a una estructura de PEER_ENDPOINT que contiene la información del punto de conexión de un mismo nivel cuyas aplicaciones se enumerarán.
Si este parámetro se establece en NULL, se enumera la información de la aplicación publicada para el punto de conexión del mismo nivel local.
[in, optional] pApplicationId
Puntero al valor guid que identifica de forma única una aplicación determinada del mismo nivel proporcionado. Si se proporciona este parámetro, la única aplicación del mismo nivel devuelta es la que coincide con este GUID.
[out] phPeerEnum
Puntero al identificador del conjunto enumerado de aplicaciones registradas que corresponden al GUID devuelto en pObjectId. Pase este identificador a PeerGetNextItem para obtener cada elemento del conjunto enumerado.
Valor devuelto
Devuelve S_OK si la función se realiza correctamente. De lo contrario, la función devuelve uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
No hay suficiente memoria para admitir esta operación. |
|
Uno de los argumentos no es válido. |
|
La infraestructura del mismo nivel de Windows no se inicializa. Se requiere llamar a la función de inicialización pertinente. |
Comentarios
Para enumerar correctamente las aplicaciones para el punto de conexión especificado, los datos de la aplicación deben estar disponibles en el punto de conexión. Para que los datos de la aplicación estén disponibles, debe producirse una de las siguientes acciones:
- El punto de conexión debe haberse obtenido previamente llamando a PeerCollabEnumEndpoints.
- El mismo nivel local debe haberse suscrito al punto de conexión llamando a PeerCollabSubscribeEndpointData.
- Los datos del punto de conexión deben actualizarse llamando a PeerCollabRefreshEndpointData correctamente.
Para obtener las aplicaciones del mismo nivel individuales, pase el identificador devuelto a PeerGetNextItem. Para cerrar la enumeración y liberar los recursos asociados, pase este identificador a PeerEndEnumeration. Los elementos individuales devueltos por la enumeración deben liberarse con PeerFreeData.
Los elementos de datos de la aplicación del mismo nivel se devuelven como estructuras de PEER_APPLICATION individuales.
La función PeerCollabEnumApplications devuelve una matriz vacía para los puntos de conexión de la subred que no son contactos de confianza.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | p2p.h |
| Library | P2P.lib |
| Archivo DLL | P2P.dll |