Collapse All
Parallels Virtualization SDK
ContentsIndex
PreviousUpNext
PrlVmCfg_SetHostSharingEnabled Function
PHT_VM_CONFIGURATION

Enables host sharing for the specified virtual machine.

Syntax
PRL_RESULT PrlVmCfg_SetHostSharingEnabled(
    PRL_HANDLE hVmCfg, 
    PRL_BOOL bVmHostSharingEnabled
);
File

PrlApiVm.h

Parameters

hVmCfg
A handle of type PHT_VM_CONFIGURATION identifying the virtual machine configuration.
bVmHostSharingEnabled
The value to set. Specify PRL_TRUE to enable sharing. Specify PRL_FALSE to disable it.

Returns

PRL_RESULT. Possible values: 

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed. 

PRL_ERR_SUCCESS - function completed successfully. 

Remarks

When host sharing is enabled, the host OS shared folders will be visible in the guest OS. To use the host sharing feature, the shared folders must be set up first using the functionality provided by the PHT_SHARE object. 

Parallels Tools must be installed to use this feature. To obtain the Parallels Tools status, use the PrlVm_GetToolsState function.

Links
© 2021 Parallels International GmbH. All rights reserved.