SET_BAND_SECURITY_PARAMETERS結構 (ehstorbandmgmt.h)
在SET_BAND_SECURITY_PARAMETERS結構中，會指定IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY要求之儲存裝置上之訊號範圍的安全性屬性參數。
語法
typedef struct _SET_BAND_SECURITY_PARAMETERS {
ULONG StructSize;
ULONG Flags;
ULONG Reserved;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG CurrentAuthKeyOffset;
ULONG NewAuthKeyOffset;
ULONG BandSecurityInfoOffset;
} SET_BAND_SECURITY_PARAMETERS, *PSET_BAND_SECURITY_PARAMETERS;
成員
StructSize
這個 結構的大小，以位元組為單位。 設定為 sizeof (SET_BAND_SECURITY_PARAMETERS) 。
Flags
安全性參數旗標。 這個值是下列的位 OR 組合。
| 值 | 意義 |
|---|---|
|
您可以快取新的驗證金鑰，以自動化某些訊號範圍作業。 |
Reserved
BandId
要傳回資訊之單一帶的標識碼。 使用 BandId 選取單一訊號範圍時，BandSize 必須為 0。若要使用 BandStart 和 BandSize 而非 BandId 來選取帶狀，請將 BandId = (ULONG) –1。
BandStart
存儲設備上的起始位元組位置，以開始進行訊號範圍搜尋。 嘗試比對 BandStart 或之後的帶狀。
CurrentAuthKeyOffset
包含訊號範圍目前驗證金鑰 之AUTH_KEY 結構的位移，以位元組為單位。 需要此驗證金鑰，且必須遵循此結構。 位移是從 SET_BAND_SECURITY_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。
NewAuthKeyOffset
包含訊號範圍新驗證金鑰 之AUTH_KEY 結構的位移，以位元組為單位。 位移是從 SET_BAND_SECURITY_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。 如果 NewAuthKeyOffset == CurrentAuthKeyOffset，則訊號範圍的驗證密鑰會保持不變。
BandSecurityInfoOffset
BAND_SECURITY_INFO 結構的位移，以位元組為單位。 位移是從 SET_BAND_SECURITY_PARAMETERS的開頭。
備註
優先順序會指定給 BandID 進行帶狀選取。 如果 BandID 大於 0，而 BandID 小於 BAND_MANAGEMENT_CAPABILITIES 的 MaxBandCount 成員，則 BandID 會當做帶比對的唯一選取準則使用。 如果 BandID == –1，則會使用 BandStart 做為比對準則來選取帶狀。 如果沒有符合任一選取準則的訊號範圍，則會在 IoStatus 區塊中傳回 IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY STATUS_INVALID_PARAMETER。
如果 BandID 和 BandStart 都設定為 –1， 則IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY 要求將會變更全域訊號範圍的屬性。
NewAuthKeyOffset 和 BandSecurityInfoOffset 是選擇性的，視作業的需求而定。 如果只有驗證密鑰變更， 則 NewAuthKeyOffset 會設定為新金鑰 的AUTH_KEY 結構位置，而 BandSecurityInfoOffset 會設定為零。 同樣地，如果只有安全性屬性變更， BandSecurityInfoOffset 會設定為 BAND_SECURITY_INFO 的位置， 而 NewAuthKeyOffset 設定為 0。
BandSecurityInfoOffset 上BAND_SECURITY_INFO結構的 CryptoAlgoIdType 和 CryptoAlgoOidString 成員不會用於訊號範圍建立要求中，而且必須設定為 0。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 8 開始提供 |
| 標頭 | ehstorbandmgmt.h (包含 EhStorBandMgmt.h) |