Result Code and Description

The XML stream returned to the Team Productivity Update by the Instantiation URL includes a <Result> tag, a <Code> tag, and a <Description> tag to indicate the success or failure of an application's instantiation. All Instantiation URLs, including both the Configure and Deploy URLs, and Delete URLs always return the <Result>.

The following code sample is an example of the Instantiation Result, Code, and Description:

<Result >
<Code> 0 </Code>
<Description> Application successfully installed </Description>
</Result>

A value of zero or greater in the <Code> tag indicates a successful instantiation. A negative value indicates failure, and the Instantiation URL should contain error-handling that passes a descriptive error message in a string variable to the <Description> tag. To see how a sample application implements the <Code> and <Description> tags, see Result Codes and Error Handling.

Success of an Instantiation or Delete URL will also trigger an e-mail message to the administrator and to the Team Workspace owner who requested the application. The message includes a pointer to the event log for more details.

If the Instantiation URL is launched from the Microsoft Management Console snap-in, a message appears on the user interface indicating the success or failure.