共用方式為


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 組合。

價值 意義
SETBANDSEC_AUTHKEY_CACHING_ENABLED
您可以快取新的驗證金鑰,以自動化某些頻帶作業。

Reserved

BandId

要傳回資訊之單一頻帶的標識碼。 當選取具有 BandId 的單一波段時,BandSize 必須是 0。 若要使用 BandStartBandSize,而不要使用 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_CAPABILITIESMaxBandCount 成員,則 BandID 會作為樂隊相符的唯一選取準則。 如果 BandID == –1,則會使用 BandStart 作為選取帶的比對準則。 如果沒有符合任一選取準則的頻帶,則會在 IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITYIoStatus 區塊中傳回STATUS_INVALID_PARAMETER。

如果 BandIDBandStart 都設定為 –1,則 IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY 要求將會變更全域頻帶的屬性。

NewAuthKeyOffsetBandSecurityInfoOffset 視作業的需求而定。 如果只有驗證密鑰變更,則 NewAuthKeyOffset 會設定為新金鑰的 AUTH_KEY 結構位置,而 BandSecurityInfoOffset 設為零。 同樣地,如果只有安全性屬性已變更,BandSecurityInfoOffset 會設定為 BAND_SECURITY_INFO 的位置,並將 NewAuthKeyOffset 設定為 0。

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

要求

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

另請參閱

BAND_LOCATION_INFO

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION