CHANGE_ATTRIBUTES_PARAMETERS 結構 (vds.h)

  • 發行項

[從Windows 8和Windows Server 2012開始，虛擬磁碟服務COM 介面會由Windows 儲存體管理 API取代。

定義資料分割樣式的資料分割參數。

語法

typedef struct _CHANGE_ATTRIBUTES_PARAMETERS {
  VDS_PARTITION_STYLE style;
  union {
    struct {
      BOOLEAN bootIndicator;
    } MbrPartInfo;
    struct {
      ULONGLONG attributes;
    } GptPartInfo;
  };
} CHANGE_ATTRIBUTES_PARAMETERS;

成員

style

決定資料分割參數。 支援的值為 VDS_PST_MBR 或 VDS_PST_GPT。

MbrPartInfo

如果樣式VDS_PST_MBR，則會使用 。 主要開機記錄 (MBR) 磁片的參數。

MbrPartInfo.bootIndicator

如果 為 TRUE，則分割區為使用中且可開機;否則，磁碟分割無法用來開機系統。

GptPartInfo

如果樣式VDS_PST_GPT，則會使用 。 GUID 資料分割資料表 (GPT) 磁片的參數。

GptPartInfo.attributes

資料分割的屬性。 可為下列一或多個值：

值 意義
GPT_ATTRIBUTE_PLATFORM_REQUIRED
0x0000000000000001
 如果設定這個屬性，電腦需要分割區才能正常運作。

例如，必須針對 OEM 磁碟分割設定這個屬性。 請注意，如果已設定此屬性，您可以使用 DiskPart.exe 公用程式來執行資料分割作業，例如刪除資料分割。 不過，因為分割區不是磁片區，所以您無法使用DiskPart.exe公用程式在分割區上執行磁片區作業。

這個屬性可以針對基本和動態磁碟進行設定。 如果已針對基本磁碟上的分割區設定，且磁片會轉換成動態磁碟，即使磁片的其餘部分是動態磁碟，分割區仍會維持基本分割區。 這是因為分割區會被視為 GPT 磁片上的 OEM 磁碟分割。
GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER
0x8000000000000000
 如果設定這個屬性，當磁片移至另一部電腦或電腦第一次看到磁片時，磁碟分割預設不會收到磁碟機號。

這個屬性在 SAN 環境中很有用。

雖然其名稱為 ，但此屬性仍可針對基本和動態磁碟進行設定。
GPT_BASIC_DATA_ATTRIBUTE_HIDDEN
0x4000000000000000
 如果已設定這個屬性，掛接管理員不會偵測資料分割。

因此，磁碟分割不會收到磁碟機號、未接收磁片區 GUID 路徑、不會裝載掛接的資料夾 (也稱為磁片區掛接點) ，而且不會透過呼叫 FindFirstVolume 和 FindNextVolume來列舉。 這可確保磁片重組器之類的應用程式不會存取磁碟分割。 磁片區陰影複製服務 (VSS) 會使用此屬性。

雖然其名稱為 ，但此屬性仍可針對基本和動態磁碟進行設定。
GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY
0x2000000000000000
 如果設定這個屬性，分割區是另一個分割區的陰影複本。

磁片區陰影複製服務會使用此屬性 (VSS) 。 此屬性工作表示檔案系統篩選驅動程式型軟體 (例如防毒軟體程式) ，以避免附加至磁片區。

應用程式可以使用 屬性來區分陰影複製磁片區與生產磁片區。 例如，執行快速復原的應用程式會清除唯讀和隱藏屬性和此屬性，以中斷陰影複製 LUN。 當陰影複製建立並清除陰影複製中斷時，就會設定這個屬性。

雖然其名稱為 ，但此屬性仍可針對基本和動態磁碟進行設定。

Windows Server 2003： Windows Server 2003 SP1 之前不支援此屬性。
GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY
0x1000000000000000
 如果設定這個屬性，則分割區是唯讀的。

寫入資料分割的所有要求都會失敗。 如果 檔案系統存在，IOCTL_DISK_IS_WRITABLE將會失敗並出現ERROR_WRITE_PROTECT Win32 錯誤碼，這會導致檔案系統掛接為唯讀。

VSS 會使用這個屬性。

請勿為動態磁碟設定此屬性。 設定可能會導致 I/O 錯誤，並防止檔案系統正確掛接。

備註

IVdsAdvancedDisk：：ChangeAttributes方法會採用這個結構做為參數。

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 vds.h

另請參閱

IVdsAdvancedDisk：：ChangeAttributes

VDS 結構