Name

VixVM_RemoveSharedFolder

Description

VixHandle
VixVM_RemoveSharedFolder(VixHandle vmHandle,
                         const char *shareName,
                         int flags,
                         VixEventProc *callbackProc,
                         void *clientData);

This function removes a shared folder in the virtual machine.

Parameters

vmHandle: Identifies a virtual machine. Call VixVM_Open() to create a virtual machine handle.
shareName: Specifies the guest pathname of the shared folder to delete.
flags: Must be 0.
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 removes a shared folder in the virtual machine referenced by vmHandle.
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.
Depending on the behavior of the guest operating system, when removing shared folders, there might be a delay before the shared folder is no longer visible to programs running within the guest operating system and to functions such as VixVM_FileExistsInGuest.

Requirements

vix.h, since VMware Workstation 6.0

Example

VixHandle jobHandle;
VixError err;

jobHandle = VixVM_RemoveSharedFolder(vmHandle,
                                     "/work",
                                     0,
                                     NULL, NULL);
err = VixJob_Wait(jobHandle, VIX_PROPERTY_NONE);
Vix_ReleaseHandle(jobHandle);
if (VIX_OK != err) {
   // handle error
}