DispInvoke 함수(oleauto.h)

아티클
08/25/2023

인터페이스에 대한 형식 정보가 제공되면 인터페이스에서 멤버 함수를 자동으로 호출합니다. 형식 정보가 있는 인터페이스를 설명하고 이 단일 호출을 사용하여 인터페이스에 대해 Invoke 를 구현할 수 있습니다.

구문

HRESULT DispInvoke(
  void       *_this,
  ITypeInfo  *ptinfo,
  DISPID     dispidMember,
  WORD       wFlags,
  DISPPARAMS *pparams,
  VARIANT    *pvarResult,
  EXCEPINFO  *pexcepinfo,
  UINT       *puArgErr
);

매개 변수

_this

ptinfo에서 설명하는 IDispatch 인터페이스의 구현입니다.

ptinfo

인터페이스를 설명하는 형식 정보입니다.

dispidMember

호출할 멤버입니다. GetIDsOfNames 또는 개체의 설명서를 사용하여 DISPID를 가져옵니다.

wFlags

Invoke 호출의 컨텍스트를 설명하는 플래그입니다.

값	의미
DISPATCH_METHOD	멤버가 메서드로 호출됩니다. 속성의 이름이 같으면 이 플래그와 DISPATCH_PROPERTYGET 플래그를 모두 설정할 수 있습니다.
DISPATCH_PROPERTYGET	멤버는 속성 또는 데이터 멤버로 검색됩니다.
DISPATCH_PROPERTYPUT	멤버가 속성 또는 데이터 멤버로 변경됩니다.
DISPATCH_PROPERTYPUTREF	멤버는 값 할당이 아닌 참조 할당에 의해 변경됩니다. 이 플래그는 속성이 개체에 대한 참조를 수락하는 경우에만 유효합니다.

pparams

인수 배열, 명명된 인수에 대한 인수 DISPID 배열 및 배열의 요소 수에 대한 개수를 포함하는 구조체에 대한 포인터입니다.

pvarResult

결과를 저장할 위치에 대한 포인터이거나 호출자가 결과가 없을 경우 Null입니다. 이 인수는 DISPATCH_PROPERTYPUT 또는 DISPATCH_PROPERTYPUTREF 지정한 경우 무시됩니다.

pexcepinfo

예외 정보를 포함하는 구조체에 대한 포인터입니다. DISP_E_EXCEPTION 반환되는 경우 이 구조체를 채워야 합니다.

puArgErr

오류가 있는 첫 번째 인수의 rgvarg 내 인덱스입니다. 인수는 역순으로 pdispparams-rgvarg>에 저장되므로 첫 번째 인수는 배열에서 인덱스가 가장 높은 인수입니다. 이 매개 변수는 결과 반환 값이 DISP_E_TYPEMISMATCH 또는 DISP_E_PARAMNOTFOUND 경우에만 반환됩니다.

반환 값

반환 코드	Description
S_OK	성공.
DISP_E_BADPARAMCOUNT	DISPPARAMS에 제공된 요소의 수는 메서드 또는 속성에서 허용하는 인수 수와 다릅니다.
DISP_E_BADVARTYPE	DISPPARAMS의 인수 중 하나는 유효한 변형 형식이 아닙니다.
DISP_E_EXCEPTION	애플리케이션에서 예외를 발생시켜야 합니다. 이 경우 pexcepinfo 로 전달된 구조체를 채워야 합니다.
DISP_E_MEMBERNOTFOUND	요청된 멤버가 없습니다.
DISP_E_NONAMEDARGS	이 IDispatch 구현은 명명된 인수를 지원하지 않습니다.
DISP_E_OVERFLOW	DISPPARAMS의 인수 중 하나를 지정된 형식으로 강제 변환할 수 없습니다.
DISP_E_PARAMNOTFOUND	매개 변수 ID 중 하나가 메서드의 매개 변수에 해당하지 않습니다. 이 경우 puArgErr 는 오류를 포함하는 첫 번째 인수로 설정됩니다.
DISP_E_PARAMNOTOPTIONAL	필수 매개 변수를 생략했습니다.
DISP_E_TYPEMISMATCH	하나 이상의 인수를 강제 변환할 수 없습니다. rgvarg 내에서 잘못된 형식을 가진 첫 번째 매개 변수의 인덱스는 puArgErr에 반환됩니다.
E_INVALIDARG	매개 변수 중 하나가 잘못되었습니다.
E_OUTOFMEMORY	메모리가 부족하여 작업을 완료할 수 없습니다.

ITypeInfo::Invoke 오류도 반환할 수 있습니다.

설명

매개 변수 _this 지연되는 인터페이스의 구현에 대한 포인터입니다. DispInvoke 는 스택 프레임을 빌드하고, 표준 강제 변환 규칙을 사용하여 매개 변수를 강제 변환하고, 스택에 푸시한 다음, VTBL에서 올바른 멤버 함수를 호출합니다.

예제

Lines 샘플 파일 Lines.cpp 다음 코드는 DispInvoke를 사용하여 Invoke를 구현합니다. 이 구현은 DispInvoke 를 사용하여 입력 인수의 유효성을 검사합니다. 보안 위험을 최소화하려면 입력 인수의 보다 강력한 유효성 검사를 수행하는 코드를 포함합니다.

STDMETHODIMP
CLines::Invoke(
   DISPID dispidMember,
   REFIID riid,
   LCID lcid,
   WORD wFlags,
   DISPPARAMS * pdispparams,
   VARIANT * pvarResult,
   EXCEPINFO* pexcepinfo,
   UINT * puArgErr)
{
   return DispInvoke(
   this, m_ptinfo,
   dispidMember, wFlags, pdispparams,
   pvarResult, pexcepinfo, puArgErr); 
}