Name

Description

HRESULT
FileExistsInGuest([in] BSTR guestPathName,
                  [in] ICallback* jobDoneCallback,
                  [out,retval] IJob** fileJob);

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

Parameters

guestPathName

The path to the file to be tested.

jobDoneCallback

A callback function that will be invoked when the operation is complete.

fileJob

Returns an IJob object that describes the state of this asynchronous operation.

Return Value

Remarks

• You must call VM::LoginInGuest(). before calling this function.
• The result of the call is in the property VIX_PROPERTY_JOB_RESULT_GUEST_OBJECT_EXISTS on the returning jobHandle.
• 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