Share via

IWTTLog::CheckResult method

  • Article

The CheckResult method checks a specified result and logs an error if the result shows a failure.

Syntax

HRESULT CheckResult(
  DWORD dwResultToCheck,
  WTTLOGGER_ERROR_TYPE dwResultType,
  BSTR bstrFile,
  UINT uiLine,
  BSTR bstrErrMsg,
  LONG hDevice
);

Parameters

  • dwResultToCheck
    [in] The result to check.

  • dwResultType
    [in] The type of the result. This parameter can be one of the following values: WTTLOG_ERROR_TYPE_HRESULTWTTLOG_ERROR_TYPE_NTSTATUSWTTLOG_ERROR_TYPE_WIN32WTTLOG_ERROR_TYPE_BOOL

  • bstrFile
    [in] The name of the source file where the assert happened.

  • uiLine
    [in] The line number within the source file where the assert happened.

  • bstrErrMsg
    [in] The text of the error message.

  • 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

CheckResult 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

Library

 WTTLogCM.dll

See also

IWTTLog Interface (COM)

IWTTLog::CheckResultEx

 

 

Build date: 9/14/2012