estrutura BAND_SECURITY_INFO (ehstorbandmgmt.h)
A estrutura BAND_SECURITY_INFO especifica as informações de segurança de uma consulta de entrada de tabela de banda.
Sintaxe
typedef struct _BAND_SECURITY_INFO {
ULONG StructSize;
LOCKSTATE ReadLock;
LOCKSTATE WriteLock;
ALGOIDTYPE CryptoAlgoIdType;
union {
struct {
ULONG Offset;
ULONG Length;
} CryptoAlgoOidString;
ULONG CryptoAlgoNumericId;
};
BYTE Metadata[32];
} BAND_SECURITY_INFO, *PBAND_SECURITY_INFO;
Membros
StructSize
O tamanho da estrutura em bytes. Defina como sizeof(BAND_SECURITY_INFO).
ReadLock
Se a banda está acessível para leitura e como um bloqueio de leitura é afetado por uma redefinição de energia.
WriteLock
Se a banda está acessível para gravação e como um bloqueio de gravação é afetado por uma redefinição de energia.
CryptoAlgoIdType
O tipo de identificador de algoritmo de criptografia usado. Isso deve ser definido como AlgoIdTypeOidString.
CryptoAlgoOidString
O algoritmo de criptografia usado para proteger os dados na banda.
CryptoAlgoOidString.Offset
O deslocamento do início dessa estrutura em que a cadeia de caracteres OID do algoritmo de criptografia começa.
CryptoAlgoOidString.Length
O comprimento da cadeia de caracteres OID que identifica o algoritmo de criptografia. Esse é um valor de comprimento de byte, incluindo um terminador NULL para a cadeia de caracteres OID.
CryptoAlgoNumericId
Reservado.
Metadata[32]
Um campo de metadados disponível para uso por um gerenciador de chaves.
Comentários
Readlock e Writelock são valores LOCKSTATE e indicam estado de bloqueio e persistência de bloqueio. Seus valores são um dos seguintes.
| Estado de bloqueio | Descrição |
|---|---|
| INVALID_LOCK_STATE | O estado de bloqueio não é válido. |
| PERSISTENT_UNLOCK | O dispositivo é desbloqueado e permanece desbloqueado durante a redefinição de energia. |
| NONPERSISTENT_UNLOCK | O dispositivo é desbloqueado, mas fica bloqueado durante a redefinição de energia. |
| PERSISTENT_LOCK | O dispositivo está bloqueado e permanece bloqueado durante a redefinição de energia. |
CryptoAlgoOidString especifica o algoritmo de criptografia de dados somente se ENUMBANDS_REPORT_CRYPTO_ALGO for definido no membro Flags do ENUMERATE_BANDS_PARAMETERS em uma solicitação de IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS . Caso contrário, CryptoAlgoOidString.Offset e CryptoAlgoOidString.Length serão definidos como 0. Veja a seguir possíveis cadeias de caracteres OID do algoritmo de criptografia retornadas para CryptoAlgoOidString.
| Algoritmo | OID |
|---|---|
| IAES128-BCE | 2.16.840.1.101.3.4.1.1 |
| AES128-CBC | 2.16.840.1.101.3.4.1.2. |
| AES128-OFB | 2.16.840.1.101.3.4.1.3 |
| AES128-CFB | 2.16.840.1.101.3.4.1.4 |
| AES128-XTS | 1.3.111.2.1619.0.1.1 |
| AES256-ECB | 2.16.840.1.101.3.4.1.41 |
| AES256-CBC | 2.16.840.1.101.3.4.1.42 |
| AES256-OFB | 2.16.840.1.101.3.4.1.43 |
| AES256-CFB | 2.16.840.1.101.3.4.1.44 |
| AES256-XTS | 1.3.111.2.1619.0.1.2 |
Quando BAND_SECURITY_INFO é usado em um conjunto de parâmetros de entrada, CryptoAlgoIdType e CryptoAlgoOidString não são usados e devem ser definidos como 0.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 8 |
| Cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |