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

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

구문

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

매개 변수

[out] ppContainer

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

반환 값

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

설명

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

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

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

요구 사항

추가 정보

IOleClientSite