PrlVmCfg_SetGuestSharingEnabled Function

Enables the guest sharing feature.

Syntax

PRL_RESULT PrlVmCfg_SetGuestSharingEnabled(
    PRL_HANDLE hVmCfg, 
    PRL_BOOL bVmGuestSharingEnabled
);

File

PrlApiVm.h

Parameters

hVmCfg

A handle of type PHT_VM_CONFIGURATION identifying the virtual machine configuration.

bVmGuestSharingEnabled

The value to set. Specify PRL_TRUE to enable guest 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

If guest sharing is enabled, the guest OS disk drives will be accessible in the host OS. If, in addition, the auto-mount feature is turned on, the guest OS disk drives will appear as icons on the host desktop. If sharing is enabled but auto-mount is not, you will not see the drives in the host OS but Smart Select feature will still work.

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

Links

PHT_VM_CONFIGURATION