共用方式為

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。

備註

BandSecurityInfoOffset 上BAND_SECURITY_INFO結構的 CryptoAlgoIdType 和 CryptoAlgoOidString 成員不會用於訊號範圍建立要求中，而且必須設定為 0。

規格需求

需求 值
最低支援的用戶端 從 Windows 8 開始提供
標頭 ehstorbandmgmt.h (包含 EhStorBandMgmt.h)

另請參閱

BAND_LOCATION_INFO

BAND_SECURITY_INFO

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND