структура PEER_INVITATION_INFO (p2p.h)

Статья
08/25/2023

Структура PEER_INVITATION_INFO определяет сведения о приглашении на присоединение к одноранговой группе. Приглашения представляются в виде строк Юникода. Чтобы получить эту структуру, передайте строку приглашения XML, созданную PeerGroupCreateInvitation , в PeerGroupParseInvitation.

Синтаксис

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;

Члены

dwSize

Задает размер этой структуры в байтах.

dwFlags

Для должно быть задано значение 0x00000000.

pwzCloudName

Указатель на строку Юникода, указывающую имя облака PNRP.

dwScope

Указывает область, под которым была зарегистрирована одноранговая группа.

Значение	Значение
PNRP_GLOBAL_SCOPE	Глобальные область, включая Интернет.
PNRP_LOCAL_SCOPE	Локальная область.
PNRP_LINK_LOCAL_SCOPE	Локальное область связи.

dwCloudFlags

Задает набор флагов, описывающих облачные функции PNRP.

Значение	Значение
PNRP_CLOUD_NO_FLAGS 0	Флаги не установлены.
PNRP_CLOUD_NAME_LOCAL 1	Имя облака недоступно на других компьютерах; он определяется локально.

pwzGroupPeerName

Указатель на строку Юникода, указывающую имя однорангового узла группы одноранговых узлов.

pwzIssuerPeerName

Указатель на строку Юникода, указывающую PNRP-имя однорангового узла, выдающего приглашение.

pwzSubjectPeerName

Указатель на строку Юникода, указывающую PNRP-имя однорангового узла, получающего приглашение.

pwzGroupFriendlyName

Указатель на строку Юникода, которая указывает понятное (отображаемое) имя группы одноранговых узлов.

pwzIssuerFriendlyName

Указатель на строку Юникода, указывающую понятное (отображаемое) имя однорангового узла, отправляющего приглашение.

pwzSubjectFriendlyName

Указатель на строку Юникода, указывающую понятное (отображаемое) имя однорангового узла, получающего приглашение.

ftValidityStart

Указывает значение UTC FILETIME , указывающее, когда приглашение становится действительным.

ftValidityEnd

Указывает значение FILETIME в формате UTC, указывающее, когда приглашение становится недействительным.

cRoles

Указывает количество GUID ролей, присутствующих в pRoles.

pRoles

Указатель на список идентификаторов GUID, указывающий объединенный набор доступных ролей. Ниже приведены доступные роли.

Значение	Значение
PEER_GROUP_ROLE_ADMIN	Эта роль может выдавать приглашения, продлевать членство, изменять свойства одноранговых групп, публиковать и обновлять записи, а также обновлять GMC других администраторов.
PEER_GROUP_ROLE_MEMBER	Роль может публиковать записи в одноранговой базе данных группы.

cClassifiers

Целочисленное значение без знака, содержащее количество строковых значений, перечисленных в ppwzClassifiers. Это поле зарезервировано для использования в будущем.

ppwzClassifiers

Список указателей на строки Юникода. Это поле зарезервировано для использования в будущем.

pSubjectPublicKey

Указатель на структуру CERT_PUBLIC_KEY_INFO , которая содержит возвращенный открытый ключ получателя и тип используемого алгоритма шифрования.

authScheme

Windows Vista или более поздней версии. Значение перечисления PEER_GROUP_AUTHENTICATION_SCHEME , указывающее тип проверки подлинности, используемой для проверки приглашенного одноранговой группы.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP
Минимальная версия сервера	Ни одна версия не поддерживается
Верхняя часть	p2p.h

См. также раздел

PeerGroupParseInvitation

Поделиться через