PrlVmCfg_SetMapSharedFoldersOnLetters Function

Enables mapping of shared host disks on drive letters for the specified virtual machine.

Syntax

PRL_RESULT PrlVmCfg_SetMapSharedFoldersOnLetters(
    PRL_HANDLE hVmCfg, 
    PRL_BOOL bMapSharedFoldersOnLetters
);

File

PrlApiVm.h

Parameters

hVmCfg

A handle of type PHT_VM_CONFIGURATION identifying the virtual machine configuration.

bMapSharedFoldersOnLetters

The value to set. Specify PRL_TRUE to map shared host disks on drive letters. Specify PRL_FALSE to not share 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 this sign switched on host disks shared into guest Windows OS will be maped on correspond drive letters. Note that host sharing should be switched on to enable this functionality.

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

Links

PHT_VM_CONFIGURATION