根据 DELETE_BAND_PARAMETERS 结构中的参数删除配置的带。 此结构是 IOCTL_EHSTOR_BANDMGMT_DELETE_BAND 请求的输入。
语法
typedef struct _DELETE_BAND_PARAMETERS {
ULONG StructSize;
ULONG Flags;
ULONG Reserved;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG AuthKeyOffset;
} DELETE_BAND_PARAMETERS, *PDELETE_BAND_PARAMETERS;
成员
StructSize
此结构的大小（以字节为单位）。 设置为 sizeof（DELETE_BAND_PARAMETERS）。
Flags
删除作标志。 此值是以下内容的按位 OR 组合。
| 价值 | 意义 |
|---|---|
|
在删除之前对带属性数据执行加密擦除。 |
Reserved
保留。
BandId
要返回其信息的单个带的标识符。 BandSize 在 BandId中选择单个带时必须为 0。 若要使用 BandStart 和 BandSize 而不是 BandId 来选择带，请将 BandId = （ULONG） –1。
BandStart
存储设备上的起始字节位置开始带搜索。 尝试在 BandStart或之后匹配一个乐队。
AuthKeyOffset
包含带的授权密钥的 AUTH_KEY 结构的偏移量（以字节为单位）。 偏移量从 DELETE_BAND_PARAMETERS的开头。 AUTH_KEY 在 ehstorbandmgmt.h 中声明为以下内容。
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
KeySize
键数据 键的大小（以字节为单位）。 如果 KeySize 设置为 0，则使用默认密钥。
钥匙
包含键数据的可变长度字节数组。
若要将默认身份验证密钥指定为带，请设置 AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY。 如果 标志 包含 DELBAND_ERASE_BEFORE_DELETE，则必须将 AuthKeyOffset 设置为 EHSTOR_BANDMGR_NO_KEY。
言论
优先于 BandID 进行带选择。 如果 BandID 大于 0，并且 BandID 小于 BAND_MANAGEMENT_CAPABILITIES的 MaxBandCount 成员，则 BandID 用作带匹配的唯一选择条件。 如果 BandID == –1，则 BandStart 用作选择带的匹配条件。 如果没有与任一选择条件匹配的带，则在 IoStatus 块中返回 IOCTL_EHSTOR_BANDMGMT_DELETE_BANDSTATUS_INVALID_PARAMETER。
如果在 标志中设置 DELBAND_ERASE_BEFORE_DELETE，则无需身份验证密钥即可删除带。 如果未设置此标志，则必须在 AuthKeyOffset中包含当前身份验证密钥。
.
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 从 Windows 8 开始可用 |
| 标头 | ehstorbandmgmt.h （包括 EhStorBandMgmt.h） |