Share via

WTTLogStartTestEx

  • Article

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

HRESULT WTTLogStartTestEx ( 
  LONG  hDevice,
  LPWSTR  pwszTUID,
  LPWSTR  pwszTestName,
  DWORD  dwTestType,
  LPWSTR  pwszParentTUID,
  LPWSTR  pwszParentTestName
);

Parameters

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

pwszTUID

[in] The globally unique identifier (GUID) for the test case.

pwszTestName

[in] The name of the test case.

dwTestType

pwszParentTUID

[in] The GUID for the parent test.

pwszParentTestName

[in] The name of the parent test.

Return Value

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.

Example

The following code example shows how to use WTTLogStartTestEx.

WTTLogStartTestEx (
   hDevice, 
   L"b55de776-ea89-4dbe-9abd-df2041040cd7",  // GUID of the test case
   L"This is a sample test,"                 // Optional test case name,
   WTTLOG_TESTCASE_TYPE_NOPARENT,            // This test case is an independent test case
   NULL,                                     // GUID of the parent test case
   NULL                                      // Optional name of the parent test case
);

WTTLogEndTestEx (
   hDevice,
   WTT_TESTCASE_RESULT_PASS,                 // Test case result
   L"b55de776-ea89-4dbe-9abd-df2041040cd7",  // GUID of the test case
   L"This is a sample test",                 // Optional test case name,
   NULL,                                     // GUID of the parent test case
   NULL                                      // Optional name of the parent test case
);

Requirements

Headers: Wttlogger.h

Library: WTTLog.dll

See Also

WTTLog Functions (C), WTTLogEndTestEx, WTTLogStartTest

Send feedback on this topic
Built on December 10, 2009