Name

VixVM_GetNumSharedFolders

Description

VixHandle
VixVM_GetNumSharedFolders(VixHandle vmHandle,
                          VixEventProc *callbackProc,
                          void *clientData);

This function returns the number of shared folders mounted in the virtual machine.

Parameters

vmHandle: Identifies a virtual machine. Call VixVM_Open() to create a virtual machine handle.
callbackProc: A callback function that will be invoked when the operation is complete.
clientData: A parameter that will be passed to the callbackProc function.

Return Value

VixHandle. A job handle that describes the state of this asynchronous operation.

Remarks

This function returns the number of shared folders mounted in the virtual machine referenced by vmHandle.
When the job is signaled, the property VIX_PROPERTY_JOB_RESULT_SHARED_FOLDER_COUNT will be available on the returned job handle
It is not necessary to call VixVM_LoginInGuest() before calling this function.
Shared folders are not supported for the following guest operating systems: Windows ME, Windows 98, Windows 95, Windows 3.x, and DOS.
In this release, this function requires the virtual machine to be powered on with VMware Tools installed.

Side Effects

None.

Requirements

vix.h, since VMware Workstation 6.0

Example

VixHandle jobHandle;
VixError err;
int numSharedFolders;

jobHandle = VixVM_GetNumSharedFolders(vmHandle, NULL, NULL);
err = VixJob_Wait(jobHandle,
                  VIX_PROPERTY_JOB_RESULT_SHARED_FOLDER_COUNT,
                  &numSharedFolders,
                  VIX_PROPERTY_NONE);
Vix_ReleaseHandle(jobHandle);
if (VIX_OK != err) {
   // handle error
}