发送此 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） |