IOCTL_EHSTOR_BANDMGMT_REVERT IOCTL (ehstorbandmgmt.h)

项目
02/29/2024

发送 此IOCTL_EHSTOR_BANDMGMT_REVERT 请求以停用存储设备上的安全功能和带管理。请求包括还原选项和身份验证密钥。

主要代码

输入缓冲区

Irp-AssociatedIrp.SystemBuffer> 处的输入缓冲区包含ACTIVATE_REVERT_PARAMETERS结构。 ACTIVATE_REVERT_PARAMETERS 在 ehstorbandmgmt.h 中声明如下。

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

系统缓冲区中的 ACTIVATE_REVERT_PARAMETERS 是 一个AUTH_KEY 结构。这会保存身份验证密钥的密钥数据字节。 AUTH_KEY 在 ehstorbandmgmt.h 中声明如下。

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

输入缓冲区长度

ACTIVATE_REVERT_PARAMETERS 结构的长度。

输出缓冲区

无。

输出缓冲区长度

无。

状态块

可以在“ 状态” 字段中返回以下值之一。

状态值	说明
STATUS_SUCCESS	存储设备上的安全功能已停用。
STATUS_INVALID_DEVICE_REQUEST	存储设备不支持带管理。
STATUS_INVALID_BUFFER_SIZE	输入缓冲区大小无效。
STATUS_INVALID_PARAMETER	输入缓冲区中的信息无效。
STATUS_ACCESS_DENIED	身份验证密钥无效。停用被拒绝。
STATUS_DEVICE_CONFIGURATION_ERROR	系统无法在受支持的模式下配置设备。
STATUS_IO_DEVICE_ERROR	通信失败。存储设备可能与安全协议不兼容。
STATUS_INVALID_DEVICE_STATE	存储设备未激活。

注解

从 IOCTL_EHSTOR_BANDMGMT_REVERT 请求成功返回后，存储设备将返回到非活动安全状态，并且除 IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES 和 IOCTL_EHSTOR_BANDMGMT_ACTIVATE之外的所有带管理 IOCTL 都不可用。

要求

要求	值
最低受支持的客户端	从Windows 8开始可用
标头	ehstorbandmgmt.h (包括 EhStorBandMgmt.h)

另请参阅

IOCTL_EHSTOR_BANDMGMT_ACTIVATE

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

通过