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

Статья
08/25/2023

Функция PeerIdentityGetFriendlyName возвращает понятное имя удостоверения однорангового узла.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetFriendlyName(
  [in]  PCWSTR pwzIdentity,
  [out] PWSTR  *ppwzFriendlyName
);

Параметры

[in] pwzIdentity

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

[out] ppwzFriendlyName

Получает указатель на понятное имя. Если ppwzFriendlyName больше не требуется, приложение отвечает за освобождение этой строки путем вызова PeerFreeData.

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

Если вызов функции выполнен успешно, возвращаемое значение будет 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

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

PeerFreeData

PeerIdentitySetFriendlyName

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