Using TaskInfo to Determine Task Status

A
Task
object provides information about the status of the invoked operation through its
TaskInfo
data object. An instance of
TaskInfo
populates the
info
property of the
Task
managed object at runtime. By monitoring properties of the
TaskInfo
object, a client application can take appropriate action when the
Task
completes, or can handle errors if the
Task
does not complete successfully.
The
Task.info
property contains a
TaskInfo
data object that contains information about the
Task
the server returns to your client application.
When a
Task
is instantiated by the server, the
TaskInfo.result
property is initialized to
Unset
. Upon successful completion of an operation, the
result
property is populated with the return type specific to the operation. The
result
might be a data object, a reference to a managed object, or any other data structure as defined by the operation.
For example:
  1. The
    ClusterComputeResource.AddHost_Task
    method returns a
    Task
    object whose
    info
    property contains a
    TaskInfo
    data object.
  2. At the start of the operation, the
    result
    property is
    Unset
    .
  3. Upon successful completion of the operation, the
    result
    property of
    TaskInfo
    contains the managed object reference of the newly added
    HostSystem
    .