FAILED macro (winerror.h)

Provides a generic test for failure on any status value.

Syntax

void FAILED(
  hr
);

Parameters

hr

The status code. This value can be an HRESULT or an SCODE. A negative number indicates failure.

Return value

None

Remarks

This macro is defined as follows:

#define FAILED(hr) (((HRESULT)(hr)) < 0)

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	winerror.h

See also

Error Handling