HcsCreateComputeSystem

說明

建立新的計算系統，如需簡單範例，請參閱 範例程式代碼。

語法

HRESULT WINAPI
HcsCreateComputeSystem(
    _In_ PCWSTR id,
    _In_ PCWSTR configuration,
    _In_ HCS_OPERATION operation,
    _In_opt_ const SECURITY_DESCRIPTOR* securityDescriptor,
    _Out_ HCS_SYSTEM* computeSystem
    );

參數

id

識別計算系統的唯一標識碼。

configuration

指定計算系統 設定的 JSON 檔。 計算系統文件應該會有 Container、VirtualMachine 或 HostedSystem 屬性集，因為它們互斥。

operation

追蹤建立作業之作業的句柄。

securityDescriptor

保留供日後使用，必須 NULL。

computeSystem

接收新建立計算系統的句柄。 呼叫者必須負責在不再使用 HcsCloseComputeSystem 釋放句柄。

傳回值

函式會 HRESULT傳回 。

如果傳回值 S_OK，表示作業已成功啟動。 呼叫端預期會使用 HcsWaitForOperationResult 或 HcsGetOperationResult取得作業的結果。

作業結果

根據如下所示的目前作業，HcsWaitForOperationResult 或 HcsGetOperationResult 的傳回值。

作業結果值	說明
S_OK	已成功建立計算系統
HCS_E_OPERATION_PENDING	尚未完全建立計算系統
其他 Windows HRESULT 值	如果建立計算系統時發生錯誤，此處的傳回值會提供可能出錯的提示

如果作業的結果未 S_OK，則結果檔可能會包含錯誤訊息。

需求

參數	說明
最低支援的用戶端	Windows 10 版本 1809
支援的最低伺服器	Windows Server 2019
目標平臺	窗戶
標題	ComputeCore.h
程式庫	ComputeCore.lib
Dll	ComputeCore.dll