Name
FileExistsInGuest
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
-
An ICallback instance that will be called when the
operation is complete.
- fileJob
-
Returns an IJob object that describes the state of this asynchronous operation.
Return Value
HRESULT
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 returned IJob object.
- 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
VixCOM.h, since VMware Workstation 6.0