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

Статья
03/15/2023

Функция PeerIdentitySetFriendlyName изменяет понятное имя для указанного удостоверения однорангового узла. Понятное имя — это понятное имя.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentitySetFriendlyName(
  [in] PCWSTR pwzIdentity,
  [in] PCWSTR pwzFriendlyName
);

Параметры

[in] pwzIdentity

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

[in] pwzFriendlyName

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

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

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

Код возврата	Описание
E_INVALIDARG	Один из параметров недопустим.
E_OUTOFMEMORY	Недостаточно памяти для выполнения указанной операции.
PEER_E_NO_KEY_ACCESS	Доступ к удостоверению однорангового узла или ключам группы одноранговых узлов запрещен. Как правило, это вызвано неправильным списком управления доступом (ACL) для папки, содержащей ключи пользователя или компьютера. Это может произойти при сбросе списка ACL вручную.
PEER_E_NOT_FOUND	Не удается найти удостоверение однорангового узла, соответствующее указанному имени.

Требования

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

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

PeerIdentityGetFriendlyName

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