Función PeerCollabRegisterApplication (p2p.h)

La función PeerCollabRegisterApplication registra una aplicación con el equipo local para que se pueda iniciar en una actividad de colaboración del mismo nivel.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRegisterApplication(
  [in] PCPEER_APPLICATION_REGISTRATION_INFO pcApplication,
  [in] PEER_APPLICATION_REGISTRATION_TYPE   registrationType
);

Parámetros

[in] pcApplication

Puntero a una estructura de PEER_APPLICATION_REGISTRATION_INFO que contiene el UUID del conjunto de características de la aplicación del mismo nivel, así como cualquier dato adicional específico del mismo nivel.

[in] registrationType

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

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.

Comentarios

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 infraestructura de colaboración puede recibir invitaciones de aplicaciones de contactos de confianza o de "Personas Near Me", que se basan en el ámbito en el que se inicia sesión la infraestructura de colaboración con el uso de PeerCollabSignin.

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.

Al registrar una aplicación, se recomienda que los desarrolladores especifiquen una ruta de acceso relativa, como %ProgramFiles%, en lugar de una ruta de acceso absoluta. Esto evita el error de la aplicación debido a un cambio en la ubicación de los archivos de aplicación. Por ejemplo, si el directorio C:\ProgramFiles se mueve a E:\.

Solo se pueden registrar las aplicaciones locales en la máquina. No es posible registrarse cuando la ruta de acceso ejecutable de una aplicación se encuentra en un recurso compartido de red, como una ruta de acceso UNC o una unidad de red asignada localmente.

Las aplicaciones se pueden registrar en los ámbitos "ALL_USERS" y "CURRENT_USER". En caso de que una aplicación se registre simultáneamente en ambos ámbitos, una aplicación registrada en el ámbito "CURRENT_USER" tiene prioridad sobre una aplicación registrada en el ámbito "ALL_USERS". Es importante tener en cuenta que para registrarse para el tipo de registro de "ALL_USERS" el autor de la llamada debe estar trabajando con privilegios administrativos.

El número máximo de aplicaciones que se pueden registrar para un registrationType específico es 64.

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_TYPE

Funciones de API de colaboración del mismo nivel

PeerCollabUnregisterApplication