Función PeerGroupJoin (p2p.h)

Artículo
08/25/2023

La función PeerGroupJoin prepara un par con una invitación para unirse a un grupo del mismo nivel existente antes de llamar a PeerGroupConnect o PeerGroupConnectByAddress.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupJoin(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzInvitation,
  [in]  PCWSTR pwzCloud,
  [out] HGROUP *phGroup
);

Parámetros

[in] pwzIdentity

Puntero a una cadena Unicode que contiene la identidad que abre el grupo del mismo nivel especificado. Si este parámetro es NULL, la implementación usa la identidad obtenida de PeerIdentityGetDefault.

[in] pwzInvitation

Puntero a una cadena Unicode que contiene la invitación XML concedida por otro elemento del mismo nivel. Se crea una invitación cuando el elemento del mismo nivel que invita llama a PeerGroupCreateInvitation o PeerGroupIssueCredentials. Se pueden obtener detalles específicos sobre esta invitación como una estructura de PEER_INVITATION_INFO llamando a PeerGroupParseInvitation. Este parámetro es obligatorio.

[in] pwzCloud

Puntero a una cadena Unicode que contiene el nombre de la nube PNRP donde se encuentra un grupo. El valor predeterminado es NULL, que indica que se debe usar la nube especificada en la invitación.

[out] phGroup

Puntero al identificador del grupo del mismo nivel. Para iniciar la comunicación con un grupo, llame a PeerGroupConnect. Este parámetro es obligatorio.

Valor devuelto

Devuelve S_OK si la operación se realiza correctamente. De lo contrario, la función devuelve uno de los valores siguientes.

Código devuelto	Descripción
E_INVALIDARG	Uno de los parámetros no es válido.
E_OUTOFMEMORY	No hay suficiente memoria disponible para completar la operación.
PEER_E_CLOUD_NAME_AMBIGUOUS	La nube no se puede detectar de forma única, por ejemplo, más de una nube coincide con el nombre proporcionado.
PEER_E_INVALID_PEER_NAME	La identidad del mismo nivel especificada en pwzIdentity no es válida.
PEER_E_INVALID_TIME_PERIOD	El período de validez especificado en la invitación no es válido. El período especificado ha expirado o la invitación aún no es válida (es decir, la fecha y hora de ValidityStart especificada aún no se ha alcanzado). Una posible razón para la devolución de este error es que el reloj del sistema se establece incorrectamente en el equipo que se une al grupo o en el equipo que emitió la invitación.
PEER_E_INVITATION_NOT_TRUSTED	La invitación no es de confianza. Esto puede deberse a modificaciones de invitación, errores o expiración.
PEER_E_NO_CLOUD	No se puede encontrar la nube.
PEER_E_UNSUPPORTED_VERSION	La invitación no es compatible con la versión actual de la infraestructura del mismo nivel.
PEER_E_NO_KEY_ACCESS	Se deniega el acceso a la identidad del mismo nivel o a las claves del grupo del mismo nivel. Normalmente, esto se debe a una lista de control de acceso (ACL) incorrecta para la carpeta que contiene las claves de usuario o equipo. Esto puede ocurrir cuando la ACL se ha restablecido manualmente.

Los errores específicos de criptografía se pueden devolver desde el proveedor base RSA de Microsoft. Estos errores tienen el prefijo CRYPT_* y se definen en Winerror.h.

Requisitos


Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack forWindows XP
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	p2p.h
Library	P2P.lib
Archivo DLL	P2P.dll