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 exclusiva 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, pois elas são mutuamente exclusivas.

operation

O identificador da operação que acompanha a operação de criação.

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 quando ele não estiver mais em uso.

Valores retornados

A função retorna HRESULT .

Se o valor retornado for S_OK, isso 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 retornado de HcsWaitForOperationResult ou HcsGetOperationResult com base na operação atual listada como abaixo.

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

Requisitos