DELETE_BAND_PARAMETERS 結構 (ehstorbandmgmt.h)

根據 DELETE_BAND_PARAMETERS 結構中的參數,刪除已設定的訊號。 這個結構是 IOCTL_EHSTOR_BANDMGMT_DELETE_BAND 要求的輸入。

語法

typedef struct _DELETE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         AuthKeyOffset;
} DELETE_BAND_PARAMETERS, *PDELETE_BAND_PARAMETERS;

成員

StructSize

這個結構的大小,以位元組為單位。 設定為 sizeof (DELETE_BAND_PARAMETERS) 。

Flags

刪除作業旗標。 這個值是下列專案的位 OR 組合。

意義
DELBAND_ERASE_BEFORE_DELETE
先執行帶狀屬性資料的密碼編譯清除,再刪除。

Reserved

保留的。

BandId

要傳回信息之單一訊號段的識別碼。 當使用BandId選取單一帶時,BandSize必須是 0。 若要使用 BandStartBandSize 而非 BandId 來選取訊號,請將 BandId = (ULONG) –1。

BandStart

儲存裝置上的起始位元組位置,以開始進行頻外搜尋。 嘗試比對 BandStart 或之後的帶狀。

AuthKeyOffset

包含訊號範圍授權金鑰之 AUTH_KEY 結構的位移,以位元組為單位。 位移是從 DELETE_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。 如果 Flags 包含 DELBAND_ERASE_BEFORE_DELETE則 AuthKeyOffset 必須設定為 EHSTOR_BANDMGR_NO_KEY

備註

優先順序會指定給 BandID 進行帶 狀選擇。 如果BandID大於 0 且BandID小於BAND_MANAGEMENT_CAPABILITIESMaxBandCount成員,則 BandID會當做頻形比對的唯一選取準則使用。 如果 BandID == –1, 則 BandStart 會作為比對準則來選取帶狀。 如果沒有符合任一選取準則的訊號範圍,STATUS_INVALID_PARAMETER 則會在 IoStatus 區塊中傳回 IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

如果旗標中已設定DELBAND_ERASE_BEFORE_DELETE,則不需要驗證金鑰即可刪除訊號。 如果未設定此旗標,則目前的驗證金鑰必須包含在 AuthKeyOffset

.

規格需求

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

另請參閱

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND