Функция PeerGroupCreatePasswordInvitation (p2p.h)

Статья
08/25/2023

Функция PeerGroupCreatePasswordInvitation возвращает СТРОКУ XML, которую может использовать указанный одноранговый узел для присоединения к группе с соответствующим паролем.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreatePasswordInvitation(
  [in]  HGROUP hGroup,
  [out] PWSTR  *ppwzInvitation
);

Параметры

[in] hGroup

Дескриптор одноранговой группы, для которой выдано это приглашение. Этот дескриптор возвращается функцией PeerGroupCreate, PeerGroupOpen или PeerGroupJoin . Это обязательный параметр.

[out] ppwzInvitation

Указатель на строку Юникода, содержащую приглашение от издателя. Это приглашение может быть передано в PeerGroupPasswordJoin получателем, чтобы присоединиться к указанной одноранговой группе. Чтобы вернуть сведения о приглашении в виде PEER_INVITATION_INFO структуры, передайте эту строку в PeerGroupParseInvitation. Чтобы освободить эти данные, передайте этот указатель в PeerFreeData.

Для этой функции необходимо, чтобы следующие поля были заданы в структуре PEER_GROUP_PROPERTIES , передаваемой в PeerGroupCreate.

pwzGroupPassword. Это поле должно содержать пароль, используемый для проверки присоединения одноранговых узлов к группе одноранговых узлов.
groupPasswordRole. Это поле должно содержать GUID роли (администратора или однорангового узла), для которой требуется пароль.
dwAuthenticationSchemes. В этом поле должен быть установлен флаг PEER_GROUP_PASSWORD_AUTHENTICATION (0x00000001).

Возвращаемое значение

Возвращает S_OK, если операция выполнена успешно; В противном случае функция возвращает одно из следующих значений.

Код возврата	Описание
E_INVALIDARG	Один из параметров недопустим.
E_OUTOFMEMORY	Недостаточно памяти для выполнения указанной операции.
PEER_E_GROUP_NOT_READY	Одноранговая группа не находится в состоянии, в котором можно добавить записи. Например, вызывается PeerGroupJoin , но синхронизация с базой данных группы не завершена.
PEER_E_CHAIN_TOO_LONG	Цепочка GMC имеет длину более 24 администраторов или участников. Дополнительные сведения о цепочках GMC см. в документации по принципу работы групповой безопасности .
PEER_E_IDENTITY_DELETED	Данные, передаваемые как pwzIdentityInfo , являются для удаленного удостоверения и больше не являются допустимыми.
PEER_E_NOT_AUTHORIZED	Одноранговый узел, который вызвал этот метод, не является администратором.
PEER_E_NO_KEY_ACCESS	Доступ к ключам удостоверений или одноранговых групп запрещен. Как правило, это вызвано неправильным списком управления доступом (ACL) для папки, содержащей ключи пользователя или компьютера. Это может произойти при сбросе списка ACL вручную.

Ошибки, связанные с шифрованием, могут быть возвращены базовым поставщиком Microsoft RSA. Эти ошибки имеют префикс CRYPT_* и определяются в Winerror.h.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	p2p.h
Библиотека	P2P.lib
DLL	P2P.dll

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