Función PeerPnrpRegister (p2p.h)

La función PeerPnrpRegister registra un elemento del mismo nivel con una nube PNRP y devuelve un identificador que se puede usar para las actualizaciones de registro.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpRegister(
  [in]           PCWSTR                       pcwzPeerName,
  [in, optional] PPEER_PNRP_REGISTRATION_INFO pRegistrationInfo,
  [out]          HREGISTRATION                *phRegistration
);

Parámetros

[in] pcwzPeerName

Puntero a una cadena Unicode terminada en cero que contiene el nombre del mismo nivel para registrarse en el servicio PNRP.

[in, optional] pRegistrationInfo

Puntero a una estructura de PEER_PNRP_REGISTRATION_INFO que contiene la información del punto de conexión para el nodo del mismo nivel de registro. Si es NULL, la API registrará el mismo nivel con todas las nubes PNRP conocidas y la infraestructura seleccionará automáticamente las direcciones registradas.

[out] phRegistration

Identificador del registro PNRP para el nodo del mismo nivel que realiza la llamada. Use este identificador para actualizar el registro o para anular el registro con el servicio PNRP.

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.

Además, esta función puede devolver valores WSA. Para obtener una lista completa de los valores posibles, consulte Códigos de error de NSP de PNRP.

Comentarios

Un identificador debe registrarse en un proceso independiente del proceso en el que se resolverá. Si se registra y se resuelve un identificador dentro del mismo proceso, no se reconocerá.

Un nombre no se puede registrar con un punto de conexión más de una vez. Cuando se requieran actualizaciones de un nombre registrado, use PeerPnrpUpdateRegistration.

Cuando pRegistrationInfo es NULL o se especifica PEER_PNRP_AUTO_ADDRESSES para cAddresses, la infraestructura mantendrá actualizadas las direcciones a medida que cambian las direcciones o los cambios de disponibilidad en la nube.

Requisitos

Consulte también

PeerPnrpUnregister

PeerPnrpUpdateRegistration