HcsCreateComputeSystem

Description

Crée un système de calcul, consultez exemple de code pour obtenir un exemple simple.

Syntaxe

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

Paramètres

id

ID unique identifiant le système de calcul.

configuration

Document JSON spécifiant les paramètres du système de calcul . Le document du système de calcul devrait avoir un Container, VirtualMachine ou HostedSystem propriété définie, car elles s’excluent mutuellement.

operation

Handle de l’opération qui suit l’opération de création.

securityDescriptor

Réservé pour une utilisation ultérieure, doit être NULL.

computeSystem

Reçoit un handle pour le système de calcul nouvellement créé. Il incombe à l’appelant de libérer le handle à l’aide de HcsCloseComputeSystem une fois qu’il n’est plus utilisé.

Valeurs de retour

La fonction retourne HRESULT.

Si la valeur de retour est S_OK, cela signifie que l’opération a démarré correctement. Les appelants sont censés obtenir le résultat de l’opération à l’aide de HcsWaitForOperationResult ou de HcsGetOperationResult.

Résultats de l’opération

Valeur de retour de HcsWaitForOperationResult ou de HcsGetOperationResult en fonction de l’opération actuelle répertoriée ci-dessous.

Valeur du résultat de l’opération	Description
S_OK	Le système de calcul a été créé avec succès
HCS_E_OPERATION_PENDING	Le système de calcul n’a pas encore été entièrement créé
Autre valeur windows HRESULT	Si un problème s’est produit lors de la création du système de calcul, la valeur de retour ici donne des indications sur ce qui aurait pu se passer mal

Si le résultat de l’opération n’est pas S_OK, il est possible que le document de résultat contienne le message d’erreur.

Spécifications

Paramètre	Description
client minimum pris en charge	Windows 10, version 1809
serveur minimum pris en charge	Windows Server 2019
plateforme cible	Windows
En-tête	ComputeCore.h
Bibliothèque	ComputeCore.lib
dll	ComputeCore.dll