다음을 통해 공유

IObjectWithSite::GetSite 메서드(ocidl.h)

  • 아티클

SetSite를 사용하여 전달된 최신 사이트를 검색합니다.

구문

HRESULT GetSite(
  [in]  REFIID riid,
  [out] void   **ppvSite
);

매개 변수

[in] riid

ppvSite에서 반환되어야 하는 인터페이스 포인터의 IID입니다.

[out] ppvSite

riid에서 요청된 인터페이스 포인터를 수신하는 포인터 변수의 주소입니다. 반환이 성공하면 *ppvSite 에는 SetSite에서 마지막으로 본 사이트에 대한 요청된 인터페이스 포인터가 포함됩니다. 반환되는 특정 인터페이스는 riid 인수에 따라 달라집니다. 기본적으로 두 인수는 QueryInterface의 인수와 동일하게 작동합니다. 적절한 인터페이스 포인터를 사용할 수 있는 경우 개체는 성공적으로 반환하기 전에 해당 포인터에서 AddRef 를 호출해야 합니다. 사용할 수 있는 사이트가 없거나 요청된 인터페이스가 지원되지 않는 경우 이 메서드는 NULL에 *ppvSite를 지정하고 실패 코드를 반환해야 합니다.

반환 값

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

반환 코드 설명
E_FAIL
 반환 시 *ppvSite 에 NULL 이 포함된 사이트가 없습니다.
E_NOINTERFACE
 사이트가 있지만 riid에서 요청한 인터페이스를 지원하지 않습니다.

설명

E_NOTIMPL 허용되지 않습니다. 이 인터페이스를 구현하는 모든 개체는 IObjectWithSite::SetSite에 표시된 마지막 사이트를 반환할 수 있어야 합니다.

요구 사항

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

추가 정보

IObjectWithSite