www.vmware.com
82
C API Reference Guide
RC1
VixJob_Wait
Function Signature
VixError
VixJob_Wait(VixHandle jobHandle,
int firstPropertyID,
...);
Parameters
Results
The error resulting from the asynchronous operation that returned the job handle.
Notes
• This function blocks until the job completes.
• If one or more property IDs are passed, their values are returned by this function.
A property is requested by passing its ID in one parameter, followed by a
reference to a storage location of the same type as the property value. After the
last reference, terminate the list with the value VIX_PROPERTY_NONE.
• The error code returned by this function is also available in the
Vix_JOB_RESULT_ERROR_CODE property of the job object.
Example
VixError err = VIX_OK;
VixHandle hostHandle = VIX_INVALID_HANDLE;
VixHandle jobHandle = VIX_INVALID_HANDLE;
VixHandle vmHandle = VIX_INVALID_HANDLE;
int errorLineNum;
jobHandle = VixHost_Connect(VIX_API_VERSION,
VIX_SERVICEPROVIDER_VMWARE_SERVER,
NULL, // hostName
0, // hostPort
NULL, // userName
NULL, // password,
0, // options
jobHandle The handle of a job object, returned from any asynchronous VIX
function.
firstPropertyID The identity of a property, or else VIX_INVALID_PROPERTY.
