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

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

  • Статья

Функция 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