IObjectWithSite::SetSite 메서드(ocidl.h)
컨테이너가 개체에 해당 사이트의 인터페이스에 대한 포인터를 전달할 수 있도록 합니다.
구문
HRESULT SetSite(
[in] IUnknown *pUnkSite
);
매개 변수
[in] pUnkSite
이 개체를 관리하는 사이트의 IUnknown 인터페이스 포인터에 대한 포인터입니다. NULL이면 개체가 해당 사이트를 더 이상 알지 못하는 기존 사이트에서 Release를 호출해야 합니다.
반환 값
이 메서드는 성공에 대한 S_OK 반환합니다.
설명
이렇게 하면 개체가 IUnknown::AddRef 를 호출하여 이 포인터를 유지해야 합니다. 개체에 이미 사이트가 있는 경우 기존 사이트의 IUnknown::Release를 호출하고, 새 사이트 포인터를 저장하고, 새 사이트의 IUnknown::AddRef를 호출해야 합니다.
E_NOTIMPL 허용되지 않습니다. SetSite 메서드를 구현하지 않으면 IObjectWithSite 인터페이스가 필요하지 않습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | ocidl.h |