Name

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

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

Requirements