estructura DRT_SETTINGS (drt.h)

  • Artículo

La estructura DRT_SETTINGS contiene la configuración utilizada por la tabla de enrutamiento distribuida local.

Sintaxis

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;

Miembros

dwSize

Tamaño de la estructura especificada por el parámetro sizeof que se encuentra en DRT_SETTINGS con el fin de permitir nuevos campos en la estructura en versiones futuras de la API de DRT.

cbKey

Especifica el número exacto de bytes para las claves de esta instancia de DRT. Actualmente solo se admiten 8 bytes. Cualquier otro valor devolverá E_INVALIDARG a través de la función DrtOpen .

bProtocolMajorVersion

Puntero a la matriz de bytes que representa la versión principal del protocolo especificada por la aplicación. Esto se empaqueta en cada paquete DRT para identificar la versión de los proveedores de seguridad o arranque en uso cuando una única instancia de DRT admite varios proveedores de seguridad o arranque.

bProtocolMinorVersion

Puntero a la matriz de bytes que representa la versión secundaria del protocolo especificada por la aplicación. Esto se empaqueta en cada paquete DRT para identificar la versión de los proveedores de seguridad o arranque en uso cuando una única instancia de DRT admite varios proveedores de seguridad o arranque.

ulMaxRoutingAddresses

Especifica el número máximo de direcciones que registra drT cuando una aplicación registra una clave. El valor máximo de este campo es 4.

pwzDrtInstancePrefix

Esta cadena forma la base del nombre de la instancia de DRT. El nombre de la instancia se puede usar para buscar los contadores de rendimiento de Windows asociados a ella.

hTransport

Controle un transporte creado por la API de creación de transporte. Se usa para abrir un DRT con un transporte especificado por la estructura DRT_SETTINGS . Actualmente solo se admite UDP IPv6 a través de DrtCreateIpv6UdpTransport.

pSecurityProvider

Puntero al proveedor de seguridad especificado para su uso. Se puede obtener una instancia del proveedor de seguridad de claves derivadas llamando a DrtCreateDerivedKeySecurityProvider.

pBootstrapProvider

Puntero al proveedor de arranque especificado para su uso. Se puede obtener una instancia del proveedor de arranque PNRP llamando a DrtCreatePnrpBootstrapResolver.

eSecurityMode

Especifica el modo de seguridad en el que el DRT debe funcionar. Todos los nodos que participan en una malla DRT deben usar el mismo modo de seguridad.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado drt.h

Consulte también

DrtCreateIpv6UdpTransport

DrtCreatePnrpBootstrapResolver

DrtOpen