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 |
|---|---|
|
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) |