Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

AfxCheckError

 

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


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

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.

System_CAPS_noteNote

This function has the same effect in debug and non-debug builds.

Example

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

oddWMP.AttachDispatch(pWMPDispatch, TRUE);

Requirements

Header: afxdisp.h

Show: