AfxCheckError

This function tests the passed SCODE to see if it is an error.

void AFXAPI AfxCheckError(
   SCODE sc 
);
throw CMemoryException*
throw COleException*

Remarks

If it is an error, the function throws an exception. If the passed SCODE is E_OUTOFMEMORY, the function throws a CMemoryException by calling AfxThrowMemoryException. Otherwise, the function throws a COleException by calling AfxThrowOleException.

This function can be used to check the return values of calls to OLE functions in your application. By testing the return value with this function in your application, you can properly react to error conditions with a minimal amount of code.

Example

AfxCheckError(::CoCreateInstance(clsidWMP, NULL, CLSCTX_INPROC_SERVER, 
   IID_IDispatch, (LPVOID*)&pWMPDispatch));

oddWMP.AttachDispatch(pWMPDispatch, TRUE);

Requirements

Header: afxdisp.h

See Also

Concepts

MFC Macros and Globals