# Name

VixVM_FileExistsInGuest

# Description

    VixHandle
    VixVM_FileExistsInGuest(VixHandle vmHandle,
                            const char *guestPathName,
                            VixEventProc *callbackProc,
                            void *clientData);

This function tests the existence of a file in the guest operating system.

# Parameters

vmHandle
  Identifies a virtual machine. Call VixVM_Open() to create a virtual machine handle.
guestPathName
  The path to the file to be tested.
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

- You must call VixVM_LoginInGuest() before calling this function.
- The result of the call is in the property VIX_PROPERTY_JOB_RESULT_GUEST_OBJECT_EXISTS on the returned job handle.
- Only absolute paths should be used for files in the guest; the resolution of relative paths is not specified.
- If guestPathName exists as a file system object, but is not a normal file (e.g. it is a directory, device, UNIX domain socket, etc), then VIX_OK is returned, and VIX_PROPERTY_JOB_RESULT_GUEST_OBJECT_EXISTS is set to FALSE.

# Side Effects

None.

# Requirements

vix.h, since VMware Workstation 6.0
Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

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