IOCTL_EHSTOR_BANDMGMT_REVERT IOCTL (ehstorbandmgmt.h)

Articolo
08/07/2023

Questa IOCTL_EHSTOR_BANDMGMT_REVERT richiesta viene inviata per disattivare le funzionalità di sicurezza e la gestione della banda in un dispositivo di archiviazione. La richiesta include le opzioni di ripristino e la chiave di autenticazione.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Il buffer di input in Irp-AssociatedIrp.SystemBuffer> contiene una struttura ACTIVATE_REVERT_PARAMETERS. ACTIVATE_REVERT_PARAMETERS viene dichiarato in ehstorbandmgmt.h come indicato di seguito.

typedef struct _ACTIVATE_REVERT_PARAMETERS
{
    ULONG           StructSize;
    ULONG           Flags;
    ULONG           AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;

Di seguito ACTIVATE_REVERT_PARAMETERS nel buffer di sistema è una struttura AUTH_KEY . Contiene i byte di dati chiave per la chiave di autenticazione. AUTH_KEY viene dichiarato in ehstorbandmgmt.h come indicato di seguito.

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

Lunghezza del buffer di input

Lunghezza di una struttura ACTIVATE_REVERT_PARAMETERS .

Buffer di output

Nessuno.

Lunghezza del buffer di output

Nessuno.

Blocco dello stato

È possibile restituire uno dei valori seguenti nel campo Stato .

Valore di stato	Descrizione
STATUS_SUCCESS	Le funzionalità di sicurezza nel dispositivo di archiviazione sono state disattivate.
STATUS_INVALID_DEVICE_REQUEST	Il dispositivo di archiviazione non supporta la gestione della banda.
STATUS_INVALID_BUFFER_SIZE	La dimensione del buffer di input non è valida.
STATUS_INVALID_PARAMETER	Le informazioni nel buffer di input non sono valide.
STATUS_ACCESS_DENIED	La chiave di autenticazione non è valida. La disattivazione viene negata.
STATUS_DEVICE_CONFIGURATION_ERROR	Il sistema non può configurare il dispositivo in modalità supportata.
STATUS_IO_DEVICE_ERROR	Comunicazione non riuscita. Il dispositivo di archiviazione potrebbe non essere compatibile con i protocolli di sicurezza.
STATUS_INVALID_DEVICE_STATE	Il dispositivo di archiviazione non è attivato.

Commenti

Al termine della restituzione da una richiesta di IOCTL_EHSTOR_BANDMGMT_REVERT , il dispositivo di archiviazione tornerà a uno stato di sicurezza inattivo e tutti i IOCTL di gestione banda, ad eccezione di IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES e IOCTL_EHSTOR_BANDMGMT_ACTIVATE, non saranno più disponibili.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8
Intestazione	ehstorbandmgmt.h (include EhStorBandMgmt.h)

Vedi anche

IOCTL_EHSTOR_BANDMGMT_ACTIVATE

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

Condividi tramite