estructura de PEER_INVITATION_INFO (p2p.h)

Artículo
03/15/2023

La estructura PEER_INVITATION_INFO define información sobre una invitación para unirse a un grupo del mismo nivel. Las invitaciones se representan como cadenas Unicode. Para obtener esta estructura, pase la cadena de invitación XML creada por PeerGroupCreateInvitation a PeerGroupParseInvitation.

Sintaxis

typedef struct peer_invitation_info_tag {
  DWORD                            dwSize;
  DWORD                            dwFlags;
  PWSTR                            pwzCloudName;
  DWORD                            dwScope;
  DWORD                            dwCloudFlags;
  PWSTR                            pwzGroupPeerName;
  PWSTR                            pwzIssuerPeerName;
  PWSTR                            pwzSubjectPeerName;
  PWSTR                            pwzGroupFriendlyName;
  PWSTR                            pwzIssuerFriendlyName;
  PWSTR                            pwzSubjectFriendlyName;
  FILETIME                         ftValidityStart;
  FILETIME                         ftValidityEnd;
  ULONG                            cRoles;
  PEER_ROLE_ID                     *pRoles;
  ULONG                            cClassifiers;
  PWSTR                            *ppwzClassifiers;
  CERT_PUBLIC_KEY_INFO             *pSubjectPublicKey;
  PEER_GROUP_AUTHENTICATION_SCHEME authScheme;
} PEER_INVITATION_INFO, *PPEER_INVITATION_INFO;

Miembros

dwSize

Especifica el tamaño de esta estructura, en bytes.

dwFlags

Debe establecerse en 0x00000000.

pwzCloudName

Puntero a una cadena Unicode que especifica el nombre de la nube PNRP.

dwScope

Especifica el ámbito en el que se registró el grupo del mismo nivel.

Valor	Significado
PNRP_GLOBAL_SCOPE	Ámbito global, incluido Internet.
PNRP_LOCAL_SCOPE	Ámbito local.
PNRP_LINK_LOCAL_SCOPE	Ámbito local de vínculo.

dwCloudFlags

Especifica un conjunto de marcas que describen las características de la nube de PNRP.

Valor	Significado
PNRP_CLOUD_NO_FLAGS 0	No se establecen marcas.
PNRP_CLOUD_NAME_LOCAL 1	El nombre de la nube no está disponible en otros equipos; se define localmente.

pwzGroupPeerName

Puntero a una cadena Unicode que especifica el nombre del mismo nivel del grupo del mismo nivel.

pwzIssuerPeerName

Puntero a una cadena Unicode que especifica el nombre PNRP del emparejamiento que emite la invitación.

pwzSubjectPeerName

Puntero a una cadena Unicode que especifica el nombre PNRP del mismo nivel que recibe la invitación.

pwzGroupFriendlyName

Puntero a una cadena Unicode que especifica el nombre descriptivo (para mostrar) del grupo del mismo nivel.

pwzIssuerFriendlyName

Puntero a una cadena Unicode que especifica el nombre descriptivo (para mostrar) del emparejamiento que emite la invitación.

pwzSubjectFriendlyName

Puntero a una cadena Unicode que especifica el nombre descriptivo (para mostrar) del mismo nivel que recibe la invitación.

ftValidityStart

Especifica un valor FILETIME UTC que indica cuándo la invitación es válida.

ftValidityEnd

Especifica un valor FILETIME UTC que indica cuándo la invitación deja de ser válida.

cRoles

Especifica el número de GUID de rol presentes en pRoles.

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, renovar pertenencias, modificar propiedades del grupo del mismo nivel, publicar y actualizar registros y renovar el GMC de otros administradores.
PEER_GROUP_ROLE_MEMBER	El rol puede publicar registros en la base de datos del grupo del mismo nivel.

cClassifiers

Valor entero sin signo que contiene el número de valores de cadena enumerados en ppwzClassifiers. Este campo está reservado para un uso futuro.

ppwzClassifiers

Lista de punteros a cadenas Unicode. Este campo está reservado para un uso futuro.

pSubjectPublicKey

Puntero a una estructura de CERT_PUBLIC_KEY_INFO que contiene la clave pública devuelta del destinatario y el tipo de algoritmo de cifrado que usa.

authScheme

Windows Vista o posterior. El PEER_GROUP_AUTHENTICATION_SCHEME valor de enumeración que indica el tipo de autenticación usado para validar el invitado de grupo del mismo nivel.

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
Encabezado	p2p.h

Consulte también

PeerGroupParseInvitation

Share via