Collapse All
Parallels C API Reference Guide
PHT_JOB
Functions Functions by Handle Legend Send Feedback

The PHT_JOB handle provides methods for managing asynchronous operations.

Description

Every asynchronous function in the Parallels API returns a handle of type PHT_JOB. An asynchronous function returns immediately and the corresponding task is processed in a background thread. The returned job object is used as a reference to the job. While the operation is running, the job object can be used to find out the status of the operation, to get a progress report, or to cancel the job if needed. When the job completes, the job object is populated with the operation return code and the operation result (where applicable). The methods provided by the object can be used to extract this information. Once you are done processing the results, you must destroy the job object using the PrlHandle_Free function. For detailed information about jobs and asynchronous functions, please also see the Parallels Virtualization SDK Programmer's Guide .

Functions
Name
Description
Cancel the specified job.
The PrlJob_GetDataPtr function is used to obtain a pointer to a buffer containing the results of an asynchronous operation.
Provides additional job error information.
Returns the job operation code.
Obtains a job progress report.
Obtains a handle of type PHT_RESULT containing the result returned by the job.
Obtains the return code from the specified job object.
Obtains the current status of the specified job.
The PrlJob_Wait function allows to use asynchronous functions synchronously.
Links
Copyright (c) 1999-2008 Parallels Software International Inc.
What do you think about this topic? Send feedback!