www.vmware.com
80
C API Reference Guide
RC1
VixJob_GetError
Function Signature
VixError
VixJob_GetError(VixHandle jobHandle);
Parameters
Results
VixError — The result returned by a completed asynchronous function.
Notes
Applications should only call this function after an asynchronous job has completed.
See also VixJob_Wait on page 82 or VixJob_CheckCompletion on page 78.
Example
VixError err = Vix_OK;
VixHandle hostHandle = VIX_INVALID_HANDLE;
VixHandle jobHandle = VIX_INVALID_HANDLE;
jobHandle = VixHost_Connect(VIX_API_VERSION,
VIX_SERVICEPROVIDER_VMWARE_SERVER,
NULL, // hostName
0, // hostPort
NULL, // userName
NULL, // password,
0, // options
VIX_INVALID_HANDLE, // propertyListHandle
NULL, // callbackProc
NULL); // clientData
VixJob_Wait(jobHandle, VIX_PROPERTY_NONE);
err = VixJob_Geterror(jobHandle);
if (VIX_OK != err) {
// Handle the error...
goto abort;
}
abort:
Vix_ReleaseHandle(jobHandle);
jobHandle The handle of a job object, returned from any asynchronous VIX
function.
