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
E_OUTOFMEMORY	No hay suficiente memoria para admitir esta operación.
E_INVALIDARG	Uno de los argumentos no es válido.
PEER_E_NOT_INITIALIZED	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

Consulte también

PEER_APPLICATION

PEER_CONTACT

PEER_ENDPOINT

Funciones de API de colaboración del mismo nivel