HcsCreateComputeSystem

BESCHREIBUNG

Erstellt ein neues Computesystem, siehe Beispielcode für einfaches Beispiel.

Syntax

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

Die Parameter

id

Eindeutige ID, die das Computesystem identifiziert.

configuration

JSON-Dokument, das die Einstellungen des Computesystemsangibt. Das Computesystemdokument wird erwartet, dass ein Container, VirtualMachine oder HostedSystem Eigenschaften festgelegt werden, da sie sich gegenseitig ausschließen.

operation

Das Handle für den Vorgang, der den Erstellungsvorgang nachverfolgt.

securityDescriptor

Reserviert für die zukünftige Verwendung, muss NULLsein.

computeSystem

Empfängt ein Handle für das neu erstellte Computesystem. Es liegt in der Verantwortung des Aufrufers, den Handle mit HcsCloseComputeSystem freizugeben, sobald es nicht mehr verwendet wird.

Rückgabewerte

Die Funktion gibt HRESULT-zurück.

Wenn der Rückgabewert S_OKist, bedeutet dies, dass der Vorgang erfolgreich gestartet wurde. Anrufer werden erwartet, dass das Ergebnis des Vorgangs mithilfe von HcsWaitForOperationResult oder HcsGetOperationResultabgerufen wird.

Vorgangsergebnisse

Der Rückgabewert von HcsWaitForOperationResult oder HcsGetOperationResult basierend auf dem aktuellen Vorgang, der wie unten aufgeführt ist.

Wenn das Ergebnis des Vorgangs nicht S_OKist, kann das Ergebnisdokument die Fehlermeldung enthalten.

Anforderungen