HcsCreateComputeSystem

Beskrivning

Skapar ett nytt beräkningssystem, se exempelkod för ett enkelt exempel.

Syntax

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

Parameterar

id

Unikt ID som identifierar beräkningssystemet.

configuration

JSON-dokument som anger inställningarna för beräkningssystem. Dokumentet för beräkningssystemet förväntas ha en Container, VirtualMachine eller HostedSystem egenskapsuppsättning eftersom de är ömsesidigt uteslutande.

operation

Handtaget till den åtgärd som spårar skapandeåtgärden.

securityDescriptor

Reserverad för framtida användning måste vara NULL.

computeSystem

Tar emot ett handtag till det nyligen skapade beräkningssystemet. Det är uppringarens ansvar att släppa handtaget med hjälp av HcsCloseComputeSystem när det inte längre används.

Returnera värden

Funktionen returnerar HRESULT-.

Om returvärdet är S_OKinnebär det att åtgärden har startats. Anropare förväntas få åtgärdens resultat med hjälp av HcsWaitForOperationResult eller HcsGetOperationResult.

Åtgärdsresultat

Returvärdet för HcsWaitForOperationResult eller HcsGetOperationResult baserat på den aktuella åtgärden som anges nedan.

Åtgärdsresultatvärde	Beskrivning
S_OK	Beräkningssystemet har skapats
HCS_E_OPERATION_PENDING	Beräkningssystemet har inte skapats helt än
Annat Windows-HRESULT-värde	Om något gick fel när du skapade beräkningssystemet ger returvärdet här tips om vad som kunde ha gått fel

Om åtgärdens resultat inte är S_OKär det möjligt att resultatdokumentet innehåller felmeddelandet.

Krav

Parameter	Beskrivning
Lägsta klient som stöds	Windows 10, version 1809
Lägsta server som stöds	Windows Server 2019
Målplattform	Windows
Rubrik	ComputeCore.h
Bibliotek	ComputeCore.lib
Dll	ComputeCore.dll