Share via

IWTTLog::StartTestEx

  • 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.

HRESULTStartTestEx (
  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

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:

  • 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

Send feedback on this topic
Built on December 10, 2009