共用方式為


(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 磁碟分區。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 vds.h
程式庫 Uuid.lib

另請參閱

IVdsPack

VDS_PACK_PROP

VDS_PARTITION_STYLE