estructura SET_BAND_SECURITY_PARAMETERS (ehstorbandmgmt.h)

Los parámetros para establecer las propiedades de seguridad de una banda en un dispositivo de almacenamiento para una solicitud de IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY se especifican en una estructura de SET_BAND_SECURITY_PARAMETERS .

Sintaxis

typedef struct _SET_BAND_SECURITY_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         CurrentAuthKeyOffset;
  ULONG         NewAuthKeyOffset;
  ULONG         BandSecurityInfoOffset;
} SET_BAND_SECURITY_PARAMETERS, *PSET_BAND_SECURITY_PARAMETERS;

Miembros

StructSize

Tamaño de esta estructura en bytes. Establézcalo en sizeof(SET_BAND_SECURITY_PARAMETERS).

Flags

Marcas de parámetros de seguridad. Este valor es una combinación OR bit a bit de lo siguiente.

Valor	Significado
SETBANDSEC_AUTHKEY_CACHING_ENABLED	La nueva clave de autenticación se puede almacenar en caché para automatizar algunas operaciones de banda.

Reserved

BandId

Identificador de una sola banda para la que se va a devolver información. BandSize debe ser 0 cuando se selecciona una sola banda con BandId. Para usar BandStart y BandSize en lugar de BandId para seleccionar una banda, establezca BandId = (ULONG) –1.

BandStart

Ubicación inicial de bytes en el dispositivo de almacenamiento para iniciar una búsqueda de banda. Se intenta hacer coincidir una banda en o después de BandStart.

CurrentAuthKeyOffset

Desplazamiento, en bytes, de una estructura de AUTH_KEY que contiene la clave de autenticación actual para la banda. Esta clave de autenticación es necesaria y debe estar presente siguiendo esta estructura. El desplazamiento es desde el principio de SET_BAND_SECURITY_PARAMETERS. AUTH_KEY se declara en ehstorbandmgmt.h como se indica a continuación.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

KeySize

Tamaño de la clave, en bytes, de los datos de clave en Key. Si KeySize se establece en 0, se usa una clave predeterminada.

Clave

Matriz de bytes de longitud variable que contiene los datos de clave.

Para especificar una clave de autenticación predeterminada en la banda, establezca AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

NewAuthKeyOffset

Desplazamiento, en bytes, de una estructura de AUTH_KEY que contiene la nueva clave de autenticación para la banda. El desplazamiento es desde el principio de SET_BAND_SECURITY_PARAMETERS. AUTH_KEY se declara en ehstorbandmgmt.h como se indica a continuación.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

KeySize

Tamaño de la clave, en bytes, de los datos de clave en Key. Si KeySize se establece en 0, se usa una clave predeterminada.

Clave

Matriz de bytes de longitud variable que contiene los datos de clave.

Para asignar una clave de autenticación predeterminada a la banda, establezca AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY. Si NewAuthKeyOffset == CurrentAuthKeyOffset, la clave de autenticación de la banda se deja sin cambios.

BandSecurityInfoOffset

Desplazamiento, en bytes, de una estructura BAND_SECURITY_INFO . El desplazamiento es desde el principio de SET_BAND_SECURITY_PARAMETERS.

Comentarios

La prioridad se da a BandID para la selección de banda. Si BandID es mayor que 0 y BandID es menor que el miembro MaxBandCount de BAND_MANAGEMENT_CAPABILITIES, bandID se usa como único criterio de selección para una coincidencia de banda. Si BandID == –1, BandStart se usa como criterio de coincidencia para seleccionar una banda. Si ninguna banda coincide con ninguno de los criterios de selección, se devuelve STATUS_INVALID_PARAMETER en el bloque IoStatus para IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY.

Si BandID y BandStart se establecen en –1, la solicitud de IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY cambiará las propiedades de la banda global.

NewAuthKeyOffset y BandSecurityInfoOffset son opcionales en función de los requisitos de la operación. Si solo se cambia la clave de autenticación, NewAuthKeyOffset se establece en la ubicación de la estructura de AUTH_KEY para la nueva clave y BandSecurityInfoOffset se establece en cero. Del mismo modo, si solo se cambian las propiedades de seguridad, BandSecurityInfoOffset se establece en la ubicación de BAND_SECURITY_INFO y NewAuthKeyOffset se establece en 0.

Los miembros CryptoAlgoIdType y CryptoAlgoOidString de la estructura de BAND_SECURITY_INFO en BandSecurityInfoOffset no se usan en una solicitud de creación de banda y deben establecerse en 0.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 8
Encabezado	ehstorbandmgmt.h (incluya EhStorBandMgmt.h)

Consulte también

BAND_LOCATION_INFO

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION