estrutura PEER_INVITATION_INFO (p2p.h)

Artigo
03/01/2024

A estrutura PEER_INVITATION_INFO define informações sobre um convite para ingressar em um grupo par. Os convites são representados como cadeias de caracteres Unicode. Para obter essa estrutura, passe a cadeia de caracteres de convite XML criada por PeerGroupCreateInvitation para PeerGroupParseInvitation.

Sintaxe

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;

Membros

dwSize

Especifica o tamanho dessa estrutura, em bytes.

dwFlags

Deve ser definido como 0x00000000.

pwzCloudName

Ponteiro para uma cadeia de caracteres Unicode que especifica o nome da nuvem PNRP.

dwScope

Especifica o escopo no qual o grupo de pares foi registrado.

Valor	Significado
PNRP_GLOBAL_SCOPE	Escopo global, incluindo a Internet.
PNRP_LOCAL_SCOPE	Escopo local.
PNRP_LINK_LOCAL_SCOPE	Escopo local do link.

dwCloudFlags

Especifica um conjunto de sinalizadores que descrevem os recursos de nuvem PNRP.

Valor	Significado
PNRP_CLOUD_NO_FLAGS 0	Nenhum sinalizador está definido.
PNRP_CLOUD_NAME_LOCAL 1	O nome da nuvem não está disponível em outros computadores; ele é definido localmente.

pwzGroupPeerName

Ponteiro para uma cadeia de caracteres Unicode que especifica o nome do par do grupo de pares.

pwzIssuerPeerName

Ponteiro para uma cadeia de caracteres Unicode que especifica o nome PNRP do par que emite o convite.

pwzSubjectPeerName

Ponteiro para uma cadeia de caracteres Unicode que especifica o nome PNRP do par que recebe o convite.

pwzGroupFriendlyName

Ponteiro para uma cadeia de caracteres Unicode que especifica o nome amigável (exibição) do grupo par.

pwzIssuerFriendlyName

Ponteiro para uma cadeia de caracteres Unicode que especifica o nome amigável (exibição) do par que emite o convite.

pwzSubjectFriendlyName

Ponteiro para uma cadeia de caracteres Unicode que especifica o nome amigável (exibição) do par que recebe o convite.

ftValidityStart

Especifica um valor FILETIME UTC que indica quando o convite se torna válido.

ftValidityEnd

Especifica um valor FILETIME UTC que indica quando o convite se torna inválido.

cRoles

Especifica o número de GUIDs de função presentes em pRoles.

pRoles

Ponteiro para uma lista de GUIDs que especifica o conjunto combinado de funções disponíveis. As funções disponíveis são as seguintes.

Valor	Significado
PEER_GROUP_ROLE_ADMIN	Essa função pode emitir convites, renovar associações, modificar propriedades de grupo de pares, publicar e atualizar registros e renovar o GMC de outros administradores.
PEER_GROUP_ROLE_MEMBER	A função pode publicar registros no banco de dados do grupo de pares.

cClassifiers

Valor inteiro sem sinal que contém o número de valores de cadeia de caracteres listados em ppwzClassifiers. Este campo é reservado para uso futuro.

ppwzClassifiers

Lista de ponteiros para cadeias de caracteres Unicode. Este campo é reservado para uso futuro.

pSubjectPublicKey

Ponteiro para uma estrutura CERT_PUBLIC_KEY_INFO que contém a chave pública retornada do destinatário e o tipo de algoritmo de criptografia que ele usa.

authScheme

Windows Vista ou posterior. O PEER_GROUP_AUTHENTICATION_SCHEME valor de enumeração que indica o tipo de autenticação usado para validar o convite do grupo par.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP
Servidor mínimo com suporte	Nenhum compatível
Cabeçalho	p2p.h

Confira também

PeerGroupParseInvitation

Compartilhar via