PrlVmCfg_SetHostSharingEnabled Function

Enables host sharing for the specified virtual machine.

Syntax

PRL_RESULT PrlVmCfg_SetHostSharingEnabled(
    PRL_HANDLE hVmCfg, 
    PRL_BOOL bVmHostSharingEnabled
);

File

PrlApi.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

PrlApi.h , PHT_VM_CONFIGURATION