IOleControlSite::GetExtendedControl 메서드(ocidl.h)

컨테이너가 실제 컨트롤을 래핑하는 데 사용하는 확장 컨트롤에 대한 IDispatch 포인터를 검색합니다.

구문

HRESULT GetExtendedControl(
  [out] IDispatch **ppDisp
);

매개 변수

[out] ppDisp

확장 컨트롤에 대한 인터페이스 포인터를 수신하는 IDispatch 포인터 변수에 대한 포인터입니다. 오류가 발생하면 구현에서 *ppDisp을NULL로 설정해야 합니다. 성공 시 호출자는 *ppDisp가 더 이상 필요하지 않은 경우 릴리스를 호출해야 합니다.

반환 값

이 메서드는 다음 값뿐만 아니라 E_OUTOFMEMORY 및 E_UNEXPECTED 표준 반환 값을 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드가 완료되었습니다.
E_NOTIMPL	컨테이너는 확장된 컨트롤을 구현하지 않습니다.
E_POINTER	ppDisp 또는 *ppDisp의 주소가 잘못되었습니다. 예를 들어 NULL일 수 있습니다.

설명

이 메서드는 컨테이너가 확장된 컨트롤에서 유지 관리하는 속성 및 메서드에 대한 실제 제어 액세스 권한을 제공합니다. 이러한 속성 및 메서드는 그렇지 않으면 컨트롤에 액세스할 수 없습니다.

발신자에 대한 참고 사항

반환된 포인터는 호출자의 책임이며 더 이상 필요하지 않을 때 해제해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ocidl.h

추가 정보

IOleControlSite