Share via

2.2.17 TASK_INFO

  • Article

The TASK_INFO structure provides information about a task on the server.

 struct taskinfo {
   LdmObjectId id;
   LdmObjectId storageId;
   LONGLONG createTime;
   LdmObjectId clientID;
   unsigned long percentComplete;
   REQSTATUS status;
   DMPROGRESS_TYPE type;
   HRESULT error;
   unsigned long tflag;
 };
 typedef struct taskinfo TASK_INFO

id: Specifies the OID for the task.

storageId: Specifies the OID of the object associated with the task.

createTime: Unused. This field MUST be set to 0 by servers and ignored by clients.

clientID: Specifies the OID of the client that requested the task.

percentComplete: Percentage of the task that is complete. This field MUST be between 0 and 100, inclusive.

status: Specifies the status of the request.

type: Specifies the kind of operation referred to by the percentComplete member. For more information, see section 2.2.18.

error: The HRESULT error if the value of the status member is REQ_FAILED.

tflag: Unused. This field MUST be set to 0 by servers and ignored by clients.

A TASK_INFO structure is returned by all Disk Management methods that perform configuration operations. The TASK_INFO structure provides information about the task that is being performed by the server in response to the request. The id member of this structure identifies this task from all other tasks being performed by the server. Notifications received by the client as a task progresses can be associated with the original request by comparing the taskId member of the notification structure with the id member of this structure.