共用方式為


IVdsAdvancedDisk::CreatePartition 方法 (vds.h)

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

在基本磁碟上建立分割區。

IVdsCreatePartitionEx::CreatePartitionEx方法會取代這個方法。

語法

HRESULT CreatePartition(
  [in]  ULONGLONG                   ullOffset,
  [in]  ULONGLONG                   ullSize,
  [in]  CREATE_PARTITION_PARAMETERS *para,
  [out] IVdsAsync                   **ppAsync
);

參數

[in] ullOffset

分割區位移。

[in] ullSize

新分割區的大小,以位元組為單位。

[in] para

CREATE_PARTITION_PARAMETERS結構所定義之參數的指標。

[out] ppAsync

IVdsAsync介面指標的位址,VDS 會在傳回時初始化。 呼叫端必須釋放 介面。 使用此指標來取消、等候或查詢作業的狀態。

傳回值

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

傳回碼/值 描述
S_OK
已成功建立分割區。
VDS_E_NO_MEDIA
0x80042412L
卸載式磁片磁碟機中沒有媒體。
VDS_E_INVALID_OPERATION
0x80042415L
媒體不支援這項作業。 例如,呼叫端無法在 CD-ROM 上建立資料分割。
VDS_E_NOT_SUPPORTED
0x80042400L
不支援在卸載式媒體上建立第二個分割區。 或者,此錯誤表示磁片是動態磁碟。
VDS_E_PARTITION_LIMIT_REACHED
0x80042407L
呼叫端嘗試建立其他主要分割區或擴充分割區時, (四個主要分割區的最大數目,或有一個擴充) 存在。
VDS_S_UPDATE_BOOTFILE_FAILED
0x00042434L
已成功建立分割區,但 VDS 無法更新開機設定資料 (BCD) 存放區中的開機選項。

Windows Server 2003: 開機選項會儲存在 itanium 系統上 x86 或 x64 系統上的 boot.ini 檔案或 NVRAM 中。

規格需求

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

另請參閱

CREATE_PARTITION_PARAMETERS

Disk 物件

IVdsAdvancedDisk

IVdsAsync

IVdsCreatePartitionEx::CreatePartitionEx