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

Функция DrtCreatePnrpBootstrapResolver (drt.h)

  • Статья

Функция DrtCreatePnrpBootstrapResolver создает сопоставитель начальной загрузки на основе протокола PNRP.

Синтаксис

HRESULT DrtCreatePnrpBootstrapResolver(
  [in]           BOOL                   fPublish,
  [in]           PCWSTR                 pwzPeerName,
  [in, optional] PCWSTR                 pwzCloudName,
  [in, optional] PCWSTR                 pwzPublishingIdentity,
  [out]          DRT_BOOTSTRAP_PROVIDER **ppResolver
);

Параметры

[in] fPublish

Если задано значение TRUE, значение PeerName, содержащееся в pwzPeerName и переданное с помощью сопоставителя начальной загрузки PNRP, публикуется локальным DRT с помощью PNRP. Этот узел будет разрешаться другими узлами с помощью поставщика начальной загрузки PNRP и будет помогать другим узлам, пытающимся выполнить начальную загрузку.

[in] pwzPeerName

Имя однорангового узла для поиска в облаке PNRP. Максимальная длина этой строки — 137 символов Юникода.

[in, optional] pwzCloudName

Имя облака для поиска drt, соответствующего MeshName.

Эта строка имеет максимальное ограничение в 256 символов Юникода. Если оставить это поле пустым, поставщик начальной загрузки PNRP будет использовать все доступные облака PNRP.

[in, optional] pwzPublishingIdentity

PeerIdentity, который публикуется в облаке PNRP, используемом для начальной загрузки. Максимальная длина этой строки — 137 символов Юникода. Важно отметить, что если для параметра fPublish задано значение TRUE, параметру PublishingIdentity должно быть разрешено публиковать указанное значение PeerName.

[out] ppResolver

Указатель на созданный сопоставитель начальной загрузки PNRP, который используется в структуре DRT_SETTINGS .

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

Эта функция возвращает S_OK об успешном выполнении. Ниже приведены другие возможные значения.

Код возврата Описание
E_OUTOFMEMORY
 Система не может выделить память для поставщика.
E_INVALIDARG
 pwzPeerName является недопустимым .
DRT_S_RETRY
 Базовые вызовы PeerPnrpStartup или PeerIdentityGetCryptKey возвращают временную ошибку. Попробуйте вызвать эту функцию еще раз.
 
Примечание Эта функция также может отображать ошибки, возвращаемые базовыми вызовами PeerPnrpStartup или PeerIdentityGetCryptKey.
 

Комментарии

Распознаватель начальной загрузки PNRP по умолчанию, созданный этой функцией, относится к drt, для который он создается. В результате его нельзя повторно использовать в нескольких DRT.

Требования

   
Минимальная версия клиента Windows 7 Профессиональная [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header drt.h
Библиотека Drtprov.lib
DLL Drt.dll

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

DRT_SETTINGS

DrtDeletePnrpBootstrapResolver