AfxThrowOleDispatchException

使用這個函式擲回例外狀況的 OLE 自動化函式內。

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

參數

• wCode
  應用程式相關的錯誤代碼。

• lpszDescription
  發生錯誤的用語描述。

• nDescriptionID
  資源識別碼的用語的錯誤描述。

• nHelpID
  說明的內容，您的應用程式的說明 (。HLP) 檔案。

備註

這個函式所提供的資訊可以顯示驅動的應用程式 (Microsoft Visual Basic 或其他 OLE 自動化用戶端應用程式)。

範例

// 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;
}

需求

標頭: <afxdisp.h>

請參閱

參考

COleException 類別

概念

MFC 巨集和全域變數