(vds.h) IVdsPack：：AddDisk 方法

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

將磁碟新增至在線套件。

語法

HRESULT AddDisk(
  [in] VDS_OBJECT_ID       DiskId,
  [in] VDS_PARTITION_STYLE PartitionStyle,
  [in] BOOL                bAsHotSpare
);

[in] DiskId

磁碟的 GUID。

[in] PartitionStyle

此樣式可以是 MBR 或 GPT。請參閱 VDS_PARTITION_STYLE 列舉。

[in] bAsHotSpare

如果為 true，VDS 可以使用磁碟作為熱備援;否則，磁碟無法用於這項作業。只有硬體提供者支持經常性存取。

這個方法可以傳回標準 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及 VDS 特定的傳回值。它也可以使用 HRESULT_FROM_WIN32 宏傳回已轉換的系統錯誤碼。錯誤可能源自 VDS 本身，或來自正在使用的基礎 VDS 提供者。可能的傳回值包括下列專案。

傳回碼/值	描述
S_OK	已成功新增磁碟。
VDS_E_NOT_AN_UNALLOCATED_DISK 0x80042418L	磁碟是未經處理的。
VDS_E_OPERATION_DENIED 0x8004240AL	正在清除要新增的磁碟。
VDS_E_PROVIDER_FAILURE 0x80042442L	作業期間發生提供者失敗。
VDS_E_NOT_SUPPORTED 0x80042400L	不支援將第二個磁碟新增至基本套件。
VDS_E_PACK_OFFLINE 0x80042444L	無法存取目標套件。
VDS_E_OBJECT_NOT_FOUND 0x80042405L	找不到磁碟。
VDS_E_DMADMIN_METHOD_CALL_FAILED 0x80042420L	邏輯磁碟管理員 (LDM) 服務無法完成方法。
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	動態提供者快取已損毀。

VDS 會實作這個方法。

這個方法會初始化原始磁碟， (未定義分割的磁碟) ，並將它新增至套件。呼叫此方法之前，原始磁碟是由 VDS 服務所擁有。這個方法傳回之後，磁碟是由基本提供者所擁有。

若要復原此方法的效果，也就是移除數據分割格式，並讓磁碟成為 VDS 服務所擁有的原始磁碟，請使用 IVdsAdvancedDisk：：Clean 方法。

您無法使用 AddDisk 重新定義現有磁碟上的分割區。

如果您將 GPT 磁碟新增至基本套件，作業會自動在磁碟上建立 MSR 磁碟分區。執行 WinPE 作業系統的裝置是例外狀況，因為系統管理員可能偏好在磁碟上建立 ESP 磁碟分區。如果存在，ESP 磁碟分區必須是磁碟上的第一個磁碟分區。

如果您將磁碟新增至動態套件，作業就不會建立 MSR 磁碟分區。