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

Статья
03/05/2024

Функция PeerGroupDelete удаляет локальные данные и сертификат, связанные с одноранговой группой.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupDelete(
  [in] PCWSTR pwzIdentity,
  [in] PCWSTR pwzGroupPeerName
);

Параметры

[in] pwzIdentity

Указатель на строку Юникода, содержащую удостоверение, открывающее указанную группу одноранговых узлов. Если этот параметр имеет значение NULL, реализация использует удостоверение, полученное из PeerIdentityGetDefault.

[in] pwzGroupPeerName

Указатель на строку Юникода, содержащую имя однорангового узла группы одноранговых узлов, для которой удаляются данные. Это обязательный параметр. Имя группы можно получить, вызвав PeerGroupGetProperties перед PeerGroupClose или проанализировав приглашение с помощью PeerGroupParseInvitation.

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

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

Примечание Если операция удаления завершается сбоем из-за ошибки файловой системы, возвращается соответствующая ошибка файловой системы.

Код возврата	Описание
E_ACCESSDENIED	Доступ к базе данных одноранговой группы запрещен. Убедитесь, что одноранговый узел имеет разрешение на выполнение этой операции. В этом случае одноранговый узел должен быть первоначальным создателем группы одноранговых узлов.
E_INVALIDARG	Один из параметров недопустим.
PEER_E_NOT_FOUND	Не удается найти одноранговую группу.
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

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

PeerGroupCreate

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