IOCTL_EHSTOR_BANDMGMT_REVERT IOCTL (ehstorbandmgmt.h)
Essa solicitação IOCTL_EHSTOR_BANDMGMT_REVERT é enviada para desativar os recursos de segurança e o gerenciamento de banda em um dispositivo de armazenamento. A solicitação inclui reverter opções e a chave de autenticação.
Código principal
Buffer de entrada
O buffer de entrada em Irp-AssociatedIrp.SystemBuffer> contém uma estrutura ACTIVATE_REVERT_PARAMETERS. ACTIVATE_REVERT_PARAMETERS é declarado em ehstorbandmgmt.h como o seguinte.
typedef struct _ACTIVATE_REVERT_PARAMETERS
{
ULONG StructSize;
ULONG Flags;
ULONG AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;
A ACTIVATE_REVERT_PARAMETERS seguinte no buffer do sistema é uma estrutura AUTH_KEY . Isso contém os bytes de dados de chave para a chave de autenticação. AUTH_KEY é declarado em ehstorbandmgmt.h como o seguinte.
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
Comprimento do buffer de entrada
O comprimento de uma estrutura ACTIVATE_REVERT_PARAMETERS .
Buffer de saída
Nenhum.
Comprimento do buffer de saída
Nenhum.
Bloco de status
Um dos valores a seguir pode ser retornado no campo Status .
| Valor do status | Descrição |
|---|---|
| STATUS_SUCCESS | Os recursos de segurança no dispositivo de armazenamento foram desativados. |
| STATUS_INVALID_DEVICE_REQUEST | O dispositivo de armazenamento não dá suporte ao gerenciamento de banda. |
| STATUS_INVALID_BUFFER_SIZE | O tamanho do buffer de entrada é inválido. |
| STATUS_INVALID_PARAMETER | As informações no buffer de entrada são inválidas. |
| STATUS_ACCESS_DENIED | A chave de autenticação é inválida. A desativação foi negada. |
| STATUS_DEVICE_CONFIGURATION_ERROR | O sistema não pode configurar o dispositivo em um modo com suporte. |
| STATUS_IO_DEVICE_ERROR | Falha na comunicação. O dispositivo de armazenamento pode ser incompatível com protocolos de segurança. |
| STATUS_INVALID_DEVICE_STATE | O dispositivo de armazenamento não está ativado. |
Comentários
No retorno bem-sucedido de uma solicitação de IOCTL_EHSTOR_BANDMGMT_REVERT , o dispositivo de armazenamento retornará a um estado de segurança inativo e todos os IOCTLs de gerenciamento de banda, exceto IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES e IOCTL_EHSTOR_BANDMGMT_ACTIVATE, ficarão indisponíveis.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 8 |
| Cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |