共用方式為

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

索引鍵資料的大小，以位元組為單位，Key。 如果 KeySize 設為 0，則會使用預設密鑰。

鑰匙

包含索引鍵數據的可變長度位元組陣列。

若要將預設授權金鑰指派給頻帶，請設定 AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY。

言論

CryptoAlgoIdType 和 CryptoAlgoOidStringBAND_SECURITY_INFO 結構的成員 BandSecurityInfoOffset 不會用於頻帶建立要求中，而且必須設定為 0。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供
標頭 ehstorbandmgmt.h （include EhStorBandMgmt.h）

另請參閱

BAND_LOCATION_INFO

BAND_SECURITY_INFO

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND