Name
GetNumSharedFolders
Description
HRESULT
GetNumSharedFolders([in] ICallback* jobDoneCallback,
[out,retval] IJob** getJob);
This function returns the number of shared folders mounted in the virtual machine.
Parameters
- jobDoneCallback
-
A callback function that will be invoked when the
operation is complete.
- getJob
-
Returns an IJob object that describes the state of this asynchronous operation.
Return Value
HRESULT
Remarks
- This function returns the number of shared folders mounted in
the virtual machine referenced by
the IVM object against which this method is invoked.
- 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
VM::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
VixCOM.h, since VMware Workstation 6.0
Example
Dim job
Dim err
Dim results
Dim numFolders
results = Nothing
Set job = vm.GetNumSharedFolders(Nothing)
err = job.Wait(Array(VixCOM.Constants.VIX_PROPERTY_JOB_RESULT_SHARED_FOLDER_COUNT), results)
If lib.ErrorIndicatesFailure(err) Then
' Handle error...
End If
numFolders = results(0)