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

Функция PeerCreatePeerName создает новое имя на основе существующего имени указанного удостоверения и классификатора однорангового узла. Однако новое удостоверение не создается вызовом PeerCreatePeerName.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCreatePeerName(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzClassifier,
  [out] PWSTR  *ppwzPeerName
);

Параметры

[in] pwzIdentity

Указывает удостоверение, используемое в качестве основы для нового имени однорангового узла. Если pwzIdentity имеет значение NULL, созданное имя не основано на удостоверении однорангового узла и, следовательно, является незащищенным именем.

Этот параметр может иметь значение NULL , только если pwzClassifier не имеет значение NULL.

[in] pwzClassifier

Указатель на строку Юникода, содержащую новый классификатор. Этот классификатор добавляется к существующей части центра в имени однорангового узла указанного удостоверения. Эта строка содержит 150 символов, включая признак конца NULL . Укажите ЗНАЧЕНИЕ NULL , чтобы вернуть имя однорангового узла удостоверения.

Этот параметр может иметь значение NULL , только если pwzIdentity не равно NULL.

[out] ppwzPeerName

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

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

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

Код возврата Описание
E_INVALIDARG
Один из параметров недопустим.
E_OUTOFMEMORY
Недостаточно памяти для выполнения указанной операции.

Комментарии

Параметр ppwzPeername должен иметь значение NULL перед вызовом функции PeerCreatePeerName .

Требования

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

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

PeerFreeData