HcsCreateComputeSystem

Descrição

Cria um novo sistema de computação, consulte exemplo de código para obter um exemplo simples.

Sintaxe

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

Id único que identifica o sistema de computação.

configuration

Documento JSON especificando as configurações do sistema de computação . Espera-se que o documento do sistema de computação tenha uma propriedade Container, VirtualMachine ou HostedSystem definida, uma vez que elas são mutuamente exclusivas.

operation

O identificador para a operação que rastreia a operação create.

securityDescriptor

Reservado para uso futuro, deve ser NULL.

computeSystem

Recebe um identificador para o sistema de computação recém-criado. É responsabilidade do chamador liberar o identificador usando HcsCloseComputeSystem assim que ele não estiver mais em uso.

Valores de retorno

A função retorna HRESULT.

Se o valor de retorno for S_OK, significa que a operação foi iniciada com êxito. Espera-se que os chamadores obtenham o resultado da operação usando HcsWaitForOperationResult ou HcsGetOperationResult.

Resultados da Operação

O valor de retorno de HcsWaitForOperationResult ou HcsGetOperationResult com base na operação atual listada abaixo.

Se o resultado da operação não for S_OK, é possível que o documento de resultado contenha a mensagem de erro.

Requerimentos