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 |