DELETE_BAND_PARAMETERS estrutura (ehstorbandmgmt.h)

Uma banda configurada é excluída de acordo com os parâmetros em uma estrutura DELETE_BAND_PARAMETERS . Essa estrutura é uma entrada para uma solicitação IOCTL_EHSTOR_BANDMGMT_DELETE_BAND .

Sintaxe

typedef struct _DELETE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         AuthKeyOffset;
} DELETE_BAND_PARAMETERS, *PDELETE_BAND_PARAMETERS;

Membros

StructSize

O tamanho dessa estrutura em bytes. Definido como sizeof(DELETE_BAND_PARAMETERS).

Flags

Excluir sinalizadores de operação. Esse valor é uma combinação OR bit a bit do seguinte.

Valor Significado
DELBAND_ERASE_BEFORE_DELETE
Execute uma apagamento criptográfico dos dados da propriedade da banda antes de excluir.

Reserved

Reservado.

BandId

O identificador de uma única banda para a qual retornar informações. BandSize deve ser 0 quando uma única banda é selecionada com BandId. Para usar BandStart e BandSize em vez de BandId para selecionar uma banda, defina BandId = (ULONG) –1.

BandStart

O local de byte inicial no dispositivo de armazenamento para iniciar uma pesquisa de banda. Uma tentativa é feita para corresponder a uma banda em ou depois do BandStart.

AuthKeyOffset

O deslocamento, em bytes, de uma estrutura AUTH_KEY que contém a chave de autorização da banda. O deslocamento é do início do DELETE_BAND_PARAMETERS. AUTH_KEY é declarado em ehstorbandmgmt.h como o seguinte.

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

KeySize

O tamanho da chave, em bytes, dos dados de chave na Chave. Se KeySize for definido como 0, uma chave padrão será usada.

Chave

Uma matriz de bytes de comprimento variável que contém os dados de chave.

Para especificar uma chave de autenticação padrão para a banda, defina AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY. Se Flags contiver DELBAND_ERASE_BEFORE_DELETE, a AuthKeyOffset deverá ser definida como EHSTOR_BANDMGR_NO_KEY.

Comentários

A precedência é dada a BandID para seleção de banda. Se BandID for maior que 0 e BandID for menor que o membro MaxBandCount do BAND_MANAGEMENT_CAPABILITIES, o BandID será usado como o único critério de seleção para uma correspondência de banda. Se BandID == –1, o BandStart será usado como critério de correspondência para selecionar uma banda. Se nenhuma banda corresponder a nenhum dos critérios de seleção, STATUS_INVALID_PARAMETER será retornado no bloco IoStatus para IOCTL_EHSTOR_BANDMGMT_DELETE_BAND.

Se DELBAND_ERASE_BEFORE_DELETE estiver definida em Sinalizadores, uma chave de autenticação não será necessária para excluir a banda. Se esse sinalizador não estiver definido, a chave de autenticação atual deverá ser incluída no AuthKeyOffset.

.

Requisitos

   
Cliente mínimo com suporte Disponível a partir de Windows 8
Cabeçalho ehstorbandmgmt.h (inclua EhStorBandMgmt.h)

Confira também

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND