HcsCreateComputeSystem

Beschrijving

Hiermee maakt u een nieuw rekensysteem. Zie voorbeeldcode voor een eenvoudig voorbeeld.

Syntaxis

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

Parameterwaarden

id

Unieke id waarmee het rekensysteem wordt geïdentificeerd.

configuration

JSON-document waarin de instellingen van het rekensysteemworden opgegeven. Het rekensysteemdocument heeft naar verwachting een Container, VirtualMachine of HostedSystem eigenschap ingesteld omdat ze elkaar wederzijds uitsluiten.

operation

De ingang naar de bewerking waarmee de maakbewerking wordt bijgehouden.

securityDescriptor

Gereserveerd voor toekomstig gebruik moet worden NULL.

computeSystem

Ontvangt een ingang voor het zojuist gemaakte rekensysteem. Het is de verantwoordelijkheid van de beller om de ingang vrij te geven met behulp van HcsCloseComputeSystem zodra deze niet meer in gebruik is.

Retourwaarden

De functie retourneert HRESULT-.

Als de retourwaarde S_OKis, betekent dit dat de bewerking is gestart. Bellers krijgen naar verwachting het resultaat van de bewerking met behulp van HcsWaitForOperationResult of HcsGetOperationResult.

Bewerkingsresultaten

De retourwaarde van HcsWaitForOperationResult of HcsGetOperationResult op basis van de huidige bewerking die hieronder wordt vermeld.

Resultaatwaarde van bewerking	Beschrijving
S_OK	Het rekensysteem is gemaakt
HCS_E_OPERATION_PENDING	Het rekensysteem is nog niet volledig gemaakt
Andere Windows HRESULT-waarde	Als er iets fout is gegaan bij het maken van het rekensysteem, geeft de retourwaarde hier hints over wat er mis kan zijn gegaan

Als het resultaat van de bewerking niet S_OKis, kan het resultaatdocument het foutbericht bevatten.

Vereisten

Maatstaf	Beschrijving
Minimaal ondersteunde clientversie	Windows 10, versie 1809
Minimaal ondersteunde server	Windows Server 2019
Doelplatform	Windows
koptekst	ComputeCore.h
Bibliotheek	ComputeCore.lib
dll-	ComputeCore.dll