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，則結果檔可能會包含錯誤訊息。

需求