# 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
    }

Copyright (C) 2007-2018 VMware, Inc. All rights reserved.