Udostępnij za pośrednictwem


AfxThrowOleDispatchException

Funkcja ta jest przydatna w celu wygenerowania wyjątku funkcji automatyzacji OLE.

void AFXAPI AfxThrowOleDispatchException( 
   WORD wCode, 
   LPCSTR lpszDescription, 
   UINT nHelpID = 0  
); 
void AFXAPI AfxThrowOleDispatchException( 
   WORD wCode, 
   UINT nDescriptionID, 
   UINT nHelpID =   -1  
);

Parametry

  • wCode
    Kod błędu specyficzne dla danej aplikacji.

  • lpszDescription
    Słowny opis błędu.

  • nDescriptionID
    Identyfikator zasobu słowny opis błędu.

  • nHelpID
    Kontekstu pomocy, aby uzyskać pomoc w aplikacji (.{(HLP) plik.

Uwagi

Informacje na tej funkcji mogą być wyświetlane przez aplikację jazdy (Microsoft Visual Basic lub innej aplikacji klienta automatyzacji OLE).

Przykład

// Sort is method of automation class CStrArrayDoc 
long CStrArrayDoc::Sort(VARIANT* vArray)
{
   USES_CONVERSION;

   // Type check VARIANT parameter. It should contain a BSTR array 
   // passed by reference. The array must be passed by reference; it is 
   // an in-out-parameter. 

   // throwing COleDispatchException allows the EXCEPINFO structure of  
   // IDispatch::Invoke() to set 
   if (V_VT(vArray) != (VT_ARRAY | VT_BSTR))
      AfxThrowOleDispatchException(1001, 
         _T("Type Mismatch in Parameter. Pass a string array by reference"));

   // ... 
   // ... 

   return 0;
}

Wymagania

Nagłówek: <afxdisp.h>

Zobacz też

Informacje

Klasa COleException

Koncepcje

Makra i funkcje globalne MFC