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

标识计算系统的唯一 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
目标平台	Windows操作系统
标头	ComputeCore.h
图书馆	ComputeCore.lib
Dll	ComputeCore.dll