IOleObject::GetClientSite 메서드(oleidl.h)

포함된 개체의 클라이언트 사이트에 대한 포인터를 검색합니다.

구문

HRESULT GetClientSite(
  [out] IOleClientSite **ppClientSite
);

매개 변수

[out] ppClientSite

개체의 클라이언트 사이트에 대한 인터페이스 포인터를 수신하는 IOleClientSite 포인터 변수의 주소입니다. 개체가 클라이언트 사이트를 아직 알지 못하거나 오류가 발생한 경우 ppClientSite 를 NULL로 설정해야 합니다. 개체가 IOleObject::GetClientSite에 대한 호출을 받을 때마다 ppClientSite에 대한 참조 수를 늘려야 합니다. ppClientSite를 사용하여 릴리스를 호출하는 것은 호출자의 책임입니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다.

설명

링크 클라이언트는 IOleClientSite::GetContainer 메서드와 함께 IOleObject::GetClientSite 메서드를 가장 일반적으로 호출하여 중첩된 개체의 계층 구조를 트래버스합니다. 링크 클라이언트는 IOleObject::GetClientSite 를 호출하여 링크 원본의 클라이언트 사이트에 대한 포인터를 가져옵니다. 그런 다음, 클라이언트는 IOleClientSite::GetContainer 를 호출하여 링크 원본의 컨테이너에 대한 포인터를 가져옵니다. 마지막으로 클라이언트는 QueryInterface 를 호출하여 IOleObject 및 IOleObject::GetClientSite 를 가져와 컨테이너 내에서 컨테이너의 클라이언트 사이트를 가져옵니다. 호출자는 이 호출 시퀀스를 반복하여 결국 다른 모든 개체가 중첩된 master 컨테이너에 대한 포인터를 검색할 수 있습니다.

발신자에게 참고 사항

포함된 개체에 클라이언트 사이트에 대한 정보를 아직 받지 못한 경우 반환된 클라이언트 사이트 포인터는 NULL 이 됩니다. 컨테이너가 개체 만들기 도우미 함수 중 하나에 NULL 클라이언트 사이트 포인터를 전달했지만 아직 개체 초기화의 일부로 IOleObject::SetClientSite 를 호출하지 않은 경우 새로 로드되거나 생성된 개체의 경우입니다.

요구 사항

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

추가 정보

IOleObject

IOleObject::SetClientSite