通过

CREATE_BAND_PARAMETERS结构（ehstorbandmgmt.h）

  • 项目

用于在存储设备上为 IOCTL_EHSTOR_BANDMGMT_CREATE_BAND 请求创建带的参数在 CREATE_BAND_PARAMETERS 结构中指定。

语法

typedef struct _CREATE_BAND_PARAMETERS {
  ULONG StructSize;
  ULONG Flags;
  ULONG BandLocationInfoOffset;
  ULONG BandSecurityInfoOffset;
  ULONG AuthKeyOffset;
} CREATE_BAND_PARAMETERS, *PCREATE_BAND_PARAMETERS;

成员

StructSize

此结构的大小（以字节为单位）。 设置为 sizeof（CREATE_BAND_PARAMETERS）。

Flags

带创建标志。 此值是以下内容的按位 OR 组合。

价值 意义
CREATEBAND_AUTHKEY_CACHING_ENABLED
 缓存此带的身份验证密钥，允许以后的作自动化。 设置此标志时，会缓存身份验证密钥，并且不锁定用于读取和写入的带。

BandLocationInfoOffset

BAND_LOCATION_INFO 结构的偏移量（以字节为单位）。 偏移量来自 CREATE_BAND_PARAMETERS的开头。

BandSecurityInfoOffset

BAND_SECURITY_INFO 结构的偏移量（以字节为单位）。 偏移量来自 CREATE_BAND_PARAMETERS的开头。 如果此值为 0，这意味着带安全信息不存在，则带的密钥管理器元数据将设置为所有零。 此外，当此成员为 0 时，读取和写入锁定状态默认为PERSISTANT_UNLOCK。

AuthKeyOffset

包含新带的授权密钥的 AUTH_KEY 结构的偏移量（以字节为单位）。 偏移量来自 CREATE_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。

言论

CryptoAlgoIdType 和 CryptoAlgoOidStringBAND_SECURITY_INFO 结构的成员在 BandSecurityInfoOffset 中不使用，并且必须设置为 0。

要求

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

另请参阅

BAND_LOCATION_INFO

BAND_SECURITY_INFO

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND