AfxThrowOleDispatchException

이 함수를 사용 하 여 OLE 자동화 함수 내에서 예외를 throw 합니다.

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 자동화 클라이언트 응용 프로그램)을 표시할 수 있습니다.

예제

// 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 매크로 전역