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

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