HcsCreateComputeSystem

Popis

Vytvoří nový výpočetní systém. Příklad najdete vzorový kód.

Syntaxe

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

Parametry

id

Jedinečné ID identifikující výpočetní systém

configuration

Dokument JSON určující nastavení výpočetního systému. Očekává se, že dokument výpočetního systému bude mít nastavenou vlastnost Container, VirtualMachine nebo HostedSystem, protože se vzájemně vylučují.

operation

Popisovač operace, která sleduje operaci vytvoření.

securityDescriptor

Vyhrazeno pro budoucí použití, musí být NULL.

computeSystem

Přijme popisovač nově vytvořeného výpočetního systému. Za uvolnění popisovače pomocí HcsCloseComputeSystem zodpovídá volající, jakmile se už nepoužívá.

Návratové hodnoty

Funkce vrátí HRESULT.

Pokud je vrácená hodnota S_OK, znamená to, že operace byla úspěšně spuštěna. Očekává se, že volající obdrží výsledek operace pomocí HcsWaitForOperationResult nebo HcsGetOperationResult.

Výsledky operace

Návratová hodnota HcsWaitForOperationResult nebo HcsGetOperationResult na základě aktuální operace uvedené níže.

Hodnota výsledku operace	Popis
S_OK	Výpočetní systém byl úspěšně vytvořen.
HCS_E_OPERATION_PENDING	Výpočetní systém ještě nebyl zcela vytvořen.
Jiná hodnota windows HRESULT	Pokud se při vytváření výpočetního systému něco nepovedlo, vrátí se tady návratová hodnota s informacemi o tom, co se mohlo pokazit.

Pokud výsledek operace není S_OK, je možné, že dokument výsledku může obsahovat chybovou zprávu.

Požadavky

Parametr	Popis
Minimální podporovaný klient	Windows 10 verze 1809
serveru s minimální podporou	Windows Server 2019
Cílová platforma	Windows
záhlaví	ComputeCore.h
Knihovna	ComputeCore.lib
dll	ComputeCore.dll