Share via


IWTTLog::EndTestEx method

The EndTestEx method traces the end of a test case and enables you to specify a GUID-based test ID and a test hierarchy.

Syntax

HRESULT EndTestEx(
  WTTLOGGER_TEST_RESULT dwResult,
  BSTR bstrTUID,
  BSTR bstrTestName,
  BSTR bstrParentTUID,
  BSTR bstrParentTestName,
  LONG hDevice
);

Parameters

  • dwResult
    [in] The test case result. This parameter must be one of the following values:

    • WTT_TESTCASE_RESULT_PASS
      This value does not guarantee that the logger will log the test case as passed. If traces are logged that indicate an error, a warning, or so on, the logger will overrides this value.

    • WTT_TESTCASE_RESULT_WARN
      This value does not guarantee that the logger will log the test case as warned. If traces are logged that indicate an error or so forth, the logger automatically overrides this value.

    • WTT_TESTCASE_RESULT_FAIL
      This value does not guarantee that the logger will log the test case as failed. If traces are logged that indicate a bug or if no error trace is logged, the logger will overrides this value.

    • WTT_TESTCASE_RESULT_BLOCKED
      This value guarantees that the logger will log the test case as blocked.

    • WTT_TESTCASE_RESULT_SKIPPED
      This value guarantees that the logger will log the test case as skipped.

  • bstrTUID
    [in] A globally unique identifier (GUID) for the test case.

  • bstrTestName
    [in] The name of the test case.

  • bstrParentTUID
    [in] A GUID for the parent test case.

  • bstrParentTestName
    [in] The name of the parent test case.

  • hDevice
    [in] A handle to the device tracing topology. You can combine multiple handles by using the bitwise OR operator (for example, hDevice1 OR hDevice2).

Return value

EndTestEx returns one of the following values:

Return code Description
S_OK

The operation was successful.

S_FALSE

The operation was successful but the last device has been detached, which has triggered a rollup.

HRESULT

The operation failed. You should use the FAILED macro to check HRESULT values.

 

Requirements

IDL

Log.IDL

Library

WTTLogCM.dll

See also

IWTTLog Interface (COM)

IWTTLog::EndTest

IWTTLog::StartTestEx

 

 

Build date: 9/14/2012