HcsShutDownComputeSystem
Description
Cleanly shuts down a compute system.
Syntax
HRESULT WINAPI
HcsShutDownComputeSystem(
_In_ HCS_SYSTEM computeSystem,
_In_ HCS_OPERATION operation,
_In_opt_ PCWSTR options
);
Parameters
computeSystem
The handle to the compute system to shut down.
operation
The handle to the operation that tracks the shutdown operation.
options
Reserved for future use. Must be NULL
.
Return Values
The function returns HRESULT.
If the return value is S_OK
, it means the operation started successfully. Callers are expected to get the operation's result using HcsWaitForOperationResult
or HcsGetOperationResult
.
Operation Results
The return value of HcsWaitForOperationResult
or HcsGetOperationResult
based on current operation listed as below.
Operation Result Value | Description |
---|---|
S_OK |
The compute system shut down successfully |
HCS_E_SYSTEM_ALREADY_STOPPED |
The operation failed if there is duplicate shutdown or terminate for same compute system |
Requirements
Parameter | Description |
---|---|
Minimum supported client | Windows 10, version 1809 |
Minimum supported server | Windows Server 2019 |
Target Platform | Windows |
Header | ComputeCore.h |
Library | ComputeCore.lib |
Dll | ComputeCore.dll |