다음을 통해 공유

IOleClientSite::GetContainer 메서드(oleidl.h)

  • 아티클

개체의 컨테이너에 대한 포인터를 검색합니다.

구문

HRESULT GetContainer(
  [out] IOleContainer **ppContainer
);

매개 변수

[out] ppContainer

컨테이너 개체에 대한 인터페이스 포인터를 수신하는 IOleContainer 포인터 변수의 주소입니다. 오류가 발생하면 구현에서 ppContainer 를 NULL로 설정해야 합니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다. 다른 가능한 반환 값은 다음과 같습니다.

반환 코드 설명
OLE_E_NOT_SUPPORTED
 클라이언트 사이트가 OLE 1 컨테이너에 있습니다.
E_NOINTERFACE
 컨테이너는 IOleContainer 인터페이스를 구현하지 않습니다.

설명

컨테이너가 포함된 개체에 대한 링크를 지원하는 경우 GetContainer 를 구현하면 링크 클라이언트가 컨테이너의 개체를 열거하고 포함 계층 구조를 재귀적으로 트래버스할 수 있습니다. 이 메서드는 선택 사항이지만 포함된 개체에 대한 링크를 지원할 것으로 예상되는 모든 컨테이너에 권장됩니다.

링크 클라이언트는 GetContainer 를 재귀적으로 호출하여 링크 원본의 컨테이너에 대한 포인터를 가져와 복합 문서 개체의 계층 구조를 트래버스할 수 있습니다. 그런 다음 QueryInterface 가 컨테이너의 IOleObject 인터페이스에 대한 포인터를 가져와서 마지막으로 IOleObject::GetClientSite 를 통해 컨테이너의 클라이언트 사이트를 컨테이너에 가져옵니다.

포함된 개체에 대한 링크를 지원하지 않는 간단한 컨테이너는 이 메서드를 구현할 필요가 없습니다. 대신 E_NOINTERFACE 반환하고 ppContainer 를 NULL로 설정할 수 있습니다.

요구 사항

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

추가 정보

IOleClientSite