Función PeerCollabEnumApplicationRegistrationInfo (p2p.h)

La función PeerCollabEnumApplicationRegistrationInfo obtiene el identificador de enumeración usado para recuperar información de la aplicación del mismo nivel.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplicationRegistrationInfo(
  [in]  PEER_APPLICATION_REGISTRATION_TYPE registrationType,
  [out] HPEERENUM                          *phPeerEnum
);

Parámetros

[in] registrationType

Valor de PEER_APPLICATION_REGISTRATION_TYPE que especifica si la aplicación del mismo nivel está registrada en el usuario actual o en todos los usuarios del equipo del mismo nivel.

[out] phPeerEnum

Puntero a un identificador de enumeración del mismo nivel para la información de registro de aplicaciones del mismo nivel. Estos datos se obtienen pasando este identificador a PeerGetNextItem.

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 obtener las aplicaciones del mismo nivel individuales, pase el identificador devuelto a PeerGetNextItem. Se devolverá una matriz de estructuras de PEER_APPLICATION_REGISTRATION_INFO . 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.

Una aplicación es un conjunto de características de software o software disponibles en el punto de conexión del mismo nivel. Normalmente, esto hace referencia a paquetes de software que admiten actividades de red del mismo nivel, como juegos u otras aplicaciones colaborativas.

La aplicación de un mismo nivel tiene un GUID que representa una sola aplicación específica. Cuando se registra una aplicación para un elemento del mismo nivel, este GUID y la aplicación correspondiente se pueden poner a disposición de todos los contactos de confianza del mismo nivel, lo que indica las actividades en las que el mismo nivel puede participar. Para anular el registro de la aplicación de un mismo nivel, llame a PeerCollabUnregisterApplication con este GUID.

Los elementos de información de registro de aplicaciones del mismo nivel se devuelven como estructuras de PEER_APPLICATION_REGISTRATION_INFO individuales.

Requisitos

Requisito	Value
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_REGISTRATION_INFO

PEER_APPLICATION_REGISTRATION_TYPE

Funciones de API de colaboración del mismo nivel

PeerCollabUnregisterApplication