Share via


IWTTLog::EndTest

The EndTest method traces the end of a test case, clears the current test case context, and sets it to the parent context.

HRESULT EndTest (
  BSTR  bstrTestName,   
  WTTLOGGER_TEST_RESULT  dwResult,     
  BSTR  bstrRepro,  
  LONG  hDevice 
);

Parameters

bstrTestName

[in] Name of the test case.

dwResult

[in] Test case result. This 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.

bstrRepro

[in] A command line number for rerunning the test. If this parameter is NULL, DTM Logger tries to get the command line for the current process.

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

EndTest returns one of the following values:

  • 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::EndTestEx, IWTTLog::StartTest

Send feedback on this topic
Built on December 10, 2009