IOCTL_EHSTOR_BANDMGMT_REVERT IOCTL (ehstorbandmgmt.h)
此 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 (include EhStorBandMgmt.h) |