Collapse All
Parallels Virtualization SDK
ContentsIndex
PreviousUpNext
PrlVm_ToolsGetShutdownCapabilities Function
PHT_VIRTUAL_MACHINE

Obtains the available capabilities of a graceful virtual machine shutdown using Parallels Tools.

Syntax
PRL_RESULT PrlVm_ToolsGetShutdownCapabilities(
    PRL_HANDLE hVm, 
    PRL_UINT32_PTR pCapsMask
);
File

PrlApiVm.h

Parameters

hVm
A handle of type PHT_VIRTUAL_MACHINE identifying the virtual machine.
pCapsMask
[out] A bitmask containing the supported graceful shutdown capabilities. See the PRL_GRACEFUL_SHUTDOWN_CAPABILITIES enumeration for available options.

Returns

PRL_RESULT. Possible values: 

PRL_ERR_FAILURE - means that for some reason capabilities of graceful shutdown tool can't be obtained. 

PRL_ERR_INVALID_ARG - invalid vm handle or null pointer was passed. 

PRL_ERR_UNINITIALIZED - Desktop object is not accessible 

PRL_ERR_UNIMPLEMENTED - guest OS shutdown isn't supported 

PRL_ERR_SUCCESS - function completed successfully. 

Remarks

When the Parallels Tools package is installed in a virtual machine, a graceful shutdown can be performed from the outside. The available shutdown capabilities depend on the guest operating system and can be obtained using this function.

Links
© 2021 Parallels International GmbH. All rights reserved.