Compartir a través de

Función PeerGroupCreateInvitation (p2p.h)

  • Artículo

La función PeerGroupCreateInvitation devuelve una cadena XML que el elemento del mismo nivel especificado puede usar para unirse a un grupo.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreateInvitation(
  [in]  HGROUP     hGroup,
  [in]  PCWSTR     pwzIdentityInfo,
  [in]  FILETIME   *pftExpiration,
  [in]  ULONG      cRoles,
  [in]  const GUID *pRoles,
  [out] PWSTR      *ppwzInvitation
);

Parámetros

[in] hGroup

Identificador del 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.

[in] pwzIdentityInfo

Puntero a una cadena Unicode que contiene el blob XML (incluido el GMC) devuelto por una llamada anterior a PeerIdentityGetXML con la identidad del mismo nivel. Como alternativa, este parámetro puede contener un puntero a un blob XML generado por PeerIdentityGetXML mediante la información del mismo nivel contenida en PEER_CONTACT para generar una invitación para un contacto del mismo nivel.

[in] pftExpiration

Especifica una estructura FILETIME UTC que contiene la fecha y hora específicas en que expira la invitación. Este valor no puede ser mayor que la duración restante del par emisor. Si este parámetro es NULL, la duración de la invitación se establece en el valor máximo posible: la duración restante del mismo nivel.

[in] cRoles

Especifica el recuento de roles en pRoleInfo.

[in] pRoles

Puntero a una lista de GUID que especifica el conjunto combinado de roles disponibles. Los roles disponibles son los siguientes.

Valor Significado
PEER_GROUP_ROLE_ADMIN
 Este rol puede emitir invitaciones, emitir credenciales y renovar el GMC de otros administradores, así como comportarse como miembro del grupo del mismo nivel.
PEER_GROUP_ROLE_MEMBER
 Este rol puede publicar registros en la base de datos de grupo.

[out] ppwzInvitation

Puntero a una cadena Unicode que contiene la invitación del emisor. El destinatario puede pasar esta invitación a PeerGroupJoin 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.

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 desde el proveedor base RSA de Microsoft. Estos errores tienen el prefijo CRYPT_* y se definen en Winerror.h.

Comentarios

Los elementos del mismo nivel no pueden crear invitaciones para elementos del mismo nivel cuyo rol asumido es superior al suyo propio. Por ejemplo, un elemento del mismo nivel de un rol miembro no puede crear una invitación para un elemento del mismo nivel en un rol de administrador.

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

Consulte también

PEER_CONTACT

PeerGroupParseInvitation

PeerIdentityGetXML