Función PeerGroupJoin (p2p.h)
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 |
|---|---|
|
Uno de los parámetros no es válido. |
|
No hay suficiente memoria disponible para completar la operación. |
|
La nube no se puede detectar de forma única, por ejemplo, más de una nube coincide con el nombre proporcionado. |
|
La identidad del mismo nivel especificada en pwzIdentity no es válida. |
|
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. |
|
La invitación no es de confianza. Esto puede deberse a modificaciones de invitación, errores o expiración. |
|
No se puede encontrar la nube. |
|
La invitación no es compatible con la versión actual de la infraestructura del mismo nivel. |
|
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 |