Compartir a través de


HcsCreateComputeSystem

Descripción

Crea un nuevo sistema de proceso, consulte código de ejemplo para obtener un ejemplo sencillo.

Sintaxis

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

Parámetros

id

Identificador único que identifica el sistema de proceso.

configuration

Documento JSON que especifica la configuración del sistema de proceso de . Se espera que el documento del sistema de proceso tenga una propiedad Container, VirtualMachine o HostedSystem establecida, ya que son mutuamente excluyentes.

operation

Identificador de la operación que realiza un seguimiento de la operación de creación.

securityDescriptor

Reservado para uso futuro, debe ser NULL.

computeSystem

Recibe un identificador del sistema de proceso recién creado. Es responsabilidad del autor de la llamada liberar el identificador mediante HcsCloseComputeSystem una vez que ya no esté en uso.

Valores devueltos

La función devuelve HRESULT .

Si el valor devuelto es S_OK, significa que la operación se inició correctamente. Se espera que los autores de llamadas obtengan el resultado de la operación mediante HcsWaitForOperationResult o HcsGetOperationResult.

Resultados de la operación

Valor devuelto de HcsWaitForOperationResult o HcsGetOperationResult en función de la operación actual que se muestra a continuación.

Valor del resultado de la operación Descripción
S_OK El sistema de proceso se creó correctamente
HCS_E_OPERATION_PENDING El sistema de proceso aún no se ha creado completamente
Otro valor de windows HRESULT Si algo salió mal al crear el sistema de proceso, el valor devuelto aquí proporcionará sugerencias sobre lo que podría haber ido mal.

Si el resultado de la operación no es S_OK, es posible que el documento de resultado contenga el mensaje de error.

Requisitos

Parámetro Descripción
cliente mínimo admitido Windows 10, versión 1809
servidor mínimo admitido Windows Server 2019
de la plataforma de destino de Windows
encabezado ComputeCore.h
Biblioteca ComputeCore.lib
dll ComputeCore.dll