Función PeerGroupCreateInvitation (p2p.h)
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.
[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 |
|---|---|
|
Uno de los parámetros no es válido. |
|
No hay suficiente memoria para realizar la operación especificada. |
|
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. |
|
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 . |
|
Los datos pasados como pwzIdentityInfo son para una identidad eliminada y ya no son válidos. |
|
El elemento del mismo nivel que llamó a este método no es un administrador. |
|
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 |