IWTTLog::CheckResultEx

  • Article

The CheckResultEx method checks a specified result against a target result and logs an error if both the value and type match.

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

Parameters

dwResultToCheck

[in] The result to check.

dwResultType

dwTargetResult

[in] The target result to check the dwResultToCheck result against.

dwTargetType

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 message for the error.

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

CheckResultEx 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

Library: WTTLogCM.dll

See Also

IWTTLog Interface (COM), IWTTLog::CheckResult

Send feedback on this topic
Built on December 10, 2009