3.1.4.3.5.1 Retrieve a Task

To retrieve a task's definition, the client MUST first know the path of the task. The path of the task is determined when the client creates the task or queries the server, as specified in section 3.1.4.3.6.

Then the client MUST invoke the SchRpcRetrieveTask method with the following parameters:

  • The path of the existing task in the path parameter.

  • An array of strings specifying the required localization languages, as specified in [RFC3066], which MUST be in priority order in languagesBuffer.

  • A pointer to an unsigned long containing the number of strings in the array in the pulNumLanguages parameter.

  • The location of a buffer to receive the localized task definition in the xmlTaskDefinition parameter.

The client MUST deallocate the xmlTaskDefinition after successful execution, as specified in [C706] section 5.1.1.1.