структура DRT_SETTINGS (drt.h)

Структура DRT_SETTINGS содержит параметры, используемые локальной таблицей распределенной маршрутизации.

Синтаксис

typedef struct drt_settings_tag {
  DWORD                  dwSize;
  ULONG                  cbKey;
  BYTE                   bProtocolMajorVersion;
  BYTE                   bProtocolMinorVersion;
  ULONG                  ulMaxRoutingAddresses;
  PWSTR                  pwzDrtInstancePrefix;
  HDRT_TRANSPORT         hTransport;
  DRT_SECURITY_PROVIDER  *pSecurityProvider;
  DRT_BOOTSTRAP_PROVIDER *pBootstrapProvider;
  DRT_SECURITY_MODE      eSecurityMode;
} DRT_SETTINGS, *PDRT_SETTINGS;

Члены

dwSize

Размер структуры, заданной параметром sizeof в DRT_SETTINGS с целью разрешения новых полей в структуре в будущих версиях API DRT.

cbKey

Указывает точное количество байтов для ключей в этом экземпляре DRT. В настоящее время поддерживается только 8 байт. Любые другие значения будут возвращать E_INVALIDARG с помощью функции DrtOpen .

bProtocolMajorVersion

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

bProtocolMinorVersion

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

ulMaxRoutingAddresses

Указывает максимальное число адресов, регистрируемое DRT, когда приложение регистрирует ключ. Максимальное значение для этого поля — 4.

pwzDrtInstancePrefix

Эта строка формирует основу имени экземпляра DRT. Имя экземпляра можно использовать для поиска связанных с ним счетчиков производительности Windows.

hTransport

Обработка транспорта, созданного API создания транспорта. Он используется для открытия DRT с транспортом, заданным структурой DRT_SETTINGS . В настоящее время через DrtCreateIpv6UdpTransport поддерживается только протокол UDP IPv6.

pSecurityProvider

Указатель на поставщик безопасности, указанный для использования. Экземпляр поставщика безопасности производных ключей можно получить, вызвав DrtCreateDerivedKeySecurityProvider.

pBootstrapProvider

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

eSecurityMode

Указывает режим безопасности, в котором должен работать DRT. Все узлы, участвующие в сетке DRT, должны использовать один и тот же режим безопасности.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 Профессиональная [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Верхняя часть	drt.h

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

DrtCreateIpv6UdpTransport

DrtCreatePnrpBootstrapResolver

DrtOpen