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	Система вычислений еще не создана полностью
Другое значение HRESULT Windows	Если что-то пошло не так при создании вычислительной системы, возвращаемое значение здесь даст намеки на то, что могло бы пойти не так

Если результат операции не S_OK, возможно, документ результата может содержать сообщение об ошибке.

Требования

Параметр	Описание
Минимально поддерживаемый клиент	Windows 10, версия 1809
минимальный поддерживаемый сервер	Windows Server 2019
целевая платформа	Виндоус
Заголовок	ComputeCore.h
Библиотека	ComputeCore.lib
dll	ComputeCore.dll