IObjectWithSite::GetSite-Methode (ocidl.h)

  • Artikel

Ruft die neueste Website ab, die mithilfe von SetSite übergeben wurde.

Syntax

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

Parameter

[in] riid

Die IID des Schnittstellenzeigers, der in ppvSite zurückgegeben werden soll.

[out] ppvSite

Adresse der Zeigervariablen, die den in riid angeforderten Schnittstellenzeiger empfängt. Nach erfolgreicher Rückgabe enthält *ppvSite den angeforderten Schnittstellenzeiger auf die Website, die zuletzt in SetSite angezeigt wurde. Die zurückgegebene schnittstelle hängt vom riid-Argument ab. Im Wesentlichen wirken die beiden Argumente identisch mit denen in QueryInterface. Wenn der entsprechende Schnittstellenzeiger verfügbar ist, muss das Objekt AddRef für diesen Zeiger aufrufen, bevor es erfolgreich zurückgibt. Wenn keine Website verfügbar ist oder die angeforderte Schnittstelle nicht unterstützt wird, muss diese Methode *ppvSite auf NULL festlegen und einen Fehlercode zurückgeben.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode Beschreibung
E_FAIL
 Es gibt keine Website, in diesem Fall enthält *ppvSitenull bei der Rückgabe.
E_NOINTERFACE
 Es gibt eine Website, die jedoch die von riid angeforderte Schnittstelle nicht unterstützt.

Hinweise

E_NOTIMPL ist nicht zulässig. Jedes Objekt, das diese Schnittstelle implementiert, muss in der Lage sein, die letzte in IObjectWithSite::SetSite gesehene Website zurückzugeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ocidl.h

Weitere Informationen

Iobjectwithsite