структура 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 |