Share via

IWTTLog::StartTestEx method

  • Article

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

Syntax

HRESULT StartTestEx(
  BSTR bstrTUID,
  BSTR bstrTestName,
  DWORD dwTestType,
  BSTR bstrParentTUID,
  BSTR bstrParentTestName,
  LONG hDevice
);

Parameters

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

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

  • dwTestType
    [in] The type of the test case. This parameter can be one of the following values: WTTLOG_TESTCASE_TYPE_NOPARENTWTTLOG_TESTCASE_TYPE_ISCHILDWTTLOG_TESTCASE_TYPE_ISSIBLINGWTTLOG_TESTCASE_TYPE_SPECIFYPARENT

  • bstrParentTUID
    [in] The GUID for the parent test.

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

  • 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

StartTestEx 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

See also

IWTTLog Interface (COM)

IWTTLog::EndTestEx

IWTTLog::StartTest

 

 

Build date: 9/14/2012