WTTLogStartTestEx function

Article
09/14/2012

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

Syntax

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
[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
pwszParentTUID
[in] The GUID for the parent test.
pwszParentTestName
[in] The name of the parent test.

Return value

This function can return one of these 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.

Remarks

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

Header	Wttlogger.h
Library	WTTLog.dll

Share via