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

Функция PeerPnrpRegister регистрирует одноранговый узел в облаке PNRP и возвращает дескриптор, который можно использовать для обновлений регистрации.

Примечание При вызове эта функция будет блокироваться, пока не будет инициирована служба PNRP.

 

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpRegister(
  [in]           PCWSTR                       pcwzPeerName,
  [in, optional] PPEER_PNRP_REGISTRATION_INFO pRegistrationInfo,
  [out]          HREGISTRATION                *phRegistration
);

Параметры

[in] pcwzPeerName

Указатель на строку Юникода, завершающуюся с нуля, которая содержит имя однорангового узла для регистрации в службе PNRP.

[in, optional] pRegistrationInfo

Указатель на структуру PEER_PNRP_REGISTRATION_INFO , содержащую сведения о конечной точке для регистрирующего однорангового узла. При значении NULL API регистрирует одноранговый узел со всеми известными облаками PNRP, а все зарегистрированные адреса автоматически выбираются инфраструктурой.

[out] phRegistration

Обработка регистрации PNRP для вызывающего однорангового узла. Используйте этот дескриптор для обновления регистрации или отмены регистрации в службе PNRP.

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

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

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

 

Кроме того, эта функция может возвращать значения WSA. Полный список возможных значений см. в разделе Коды ошибок NSP PNRP.

Комментарии

Дескриптор должен быть зарегистрирован в процессе, отдельном от процесса, в который он будет разрешаться. Если дескриптор зарегистрирован и разрешен в рамках одного процесса, он не будет распознана.

Имя не может быть зарегистрировано в конечной точке более одного раза. Если требуется обновить зарегистрированное имя, используйте PeerPnrpUpdateRegistration.

Если значение pRegistrationInfo равно NULL или PEER_PNRP_AUTO_ADDRESSES указано для cAddresses, инфраструктура будет поддерживать зарегистрированные адреса в актуальном состоянии по мере изменения адресов или изменения доступности облака.

Требования

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

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

PeerPnrpUnregister

PeerPnrpUpdateRegistration