AfxThrowOleDispatchException

使用這個函式擲回在 OLE Automation 函式內的例外狀況。

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

參數

• wCode
  對應用程式的錯誤碼特定。

• lpszDescription
  錯誤的詳細描述。

• nDescriptionID
  用語錯誤描述的資源 ID。

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

備註

資訊提供給這個函式可以巡覽的應用程式 (Microsoft Visual Basic 或其他 OLE Automation 用戶端應用程式)。

範例

// 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 巨集和全域