Compartir a través de

Función PeerGroupCreatePasswordInvitation (p2p.h)

  • Artículo

La función PeerGroupCreatePasswordInvitation devuelve una cadena XML que el elemento del mismo nivel especificado puede usar para unir un grupo con una contraseña coincidente.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreatePasswordInvitation(
  [in]  HGROUP hGroup,
  [out] PWSTR  *ppwzInvitation
);

Parámetros

[in] hGroup

Controle al grupo del mismo nivel para el que se emite esta invitación. La función PeerGroupCreate, PeerGroupOpen o PeerGroupJoin devuelve este identificador. Este parámetro es obligatorio.

[out] ppwzInvitation

Puntero a una cadena Unicode que contiene la invitación del emisor. El destinatario puede pasar esta invitación a PeerGroupPasswordJoin para unirse al grupo del mismo nivel especificado. Para devolver los detalles de la invitación como una estructura de PEER_INVITATION_INFO , pase esta cadena a PeerGroupParseInvitation. Para liberar estos datos, pase este puntero a PeerFreeData.

Esta función requiere que los campos siguientes se establezcan en la estructura de PEER_GROUP_PROPERTIES que se pasa a PeerGroupCreate.

  • pwzGroupPassword. Este campo debe contener la contraseña usada para validar los elementos del mismo nivel que se unen al grupo del mismo nivel.
  • groupPasswordRole. Este campo debe contener el GUID del rol (administrador o del mismo nivel) para el que se requiere la contraseña.
  • dwAuthenticationSchemes. Este campo debe tener la marca PEER_GROUP_PASSWORD_AUTHENTICATION (0x00000001) establecida en él.

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 para realizar la operación especificada.
PEER_E_GROUP_NOT_READY
 El grupo del mismo nivel no está en un estado en el que se pueden agregar registros. Por ejemplo, se llama a PeerGroupJoin , pero no se ha completado la sincronización con la base de datos de grupo.
PEER_E_CHAIN_TOO_LONG
 La cadena GMC tiene más de 24 administradores o miembros. Para obtener más información sobre las cadenas GMC, consulte la documentación sobre cómo funciona la seguridad de grupo .
PEER_E_IDENTITY_DELETED
 Los datos pasados como pwzIdentityInfo son para una identidad eliminada y ya no son válidos.
PEER_E_NOT_AUTHORIZED
 El elemento del mismo nivel que llamó a este método no es un administrador.
PEER_E_NO_KEY_ACCESS
 Se deniega el acceso a las claves de identidad o 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 restablece manualmente.
 

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

Requisitos

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