AfxOleGetMessageFilter

COleMessageFilter* AFXAPI AfxOleGetMessageFilter( );

#include <afxwin.h>

Return Value

A pointer to the current message filter.

Remarks

Retrieves the application’s current message filter. Call this function to access the current COleMessageFilter-derived object, just as you would call AfxGetApp to access the current application object.

Example

// example of AfxOleGetMessageFilter
COleMessageFilter* pFilter = AfxOleGetMessageFilter();
ASSERT_VALID(pFilter);
pFilter->BeginBusyState();
// do things requiring a busy state
pFilter->EndBusyState();

// another example
//CWinApp-derived class
BOOL CSAProjApp::InitInstance()
{
   // Initialize OLE libraries and registers default message filter.
   if (!AfxOleInit())
   {
      AfxMessageBox("Ole initialization failed\n");
      return FALSE;
   }

   CWinThread* pThread = AfxGetThread();
   if (pThread != NULL)
   {
      // Destroy message filter, thereby unregistering it.
      delete pThread->m_pMessageFilter;
      pThread->m_pMessageFilter = NULL;

      // Create the new message filter object.
      //CMyMessageFilter is derived from COleMessageFilter
      pThread->m_pMessageFilter = new CMyMessageFilter;
      ASSERT(AfxOleGetMessageFilter() != NULL);

      // Register the new message filter object.
      AfxOleGetMessageFilter()->Register();
   }
   //...
   //...
   //...
}

See Also   COleMessageFilter, AfxGetApp