IUnknown_GetSite-Funktion (shlwapi.h)

  • Artikel

Ruft die IObjectWithSite::GetSite-Methode des angegebenen Objekts auf.

Syntax

LWSTDAPI IUnknown_GetSite(
  [in]  IUnknown *punk,
  [in]  REFIID   riid,
  [out] void     **ppv
);

Parameter

[in] punk

Typ: IUnknown*

Ein Zeiger auf das COM-Objekt, dessen IObjectWithSite::GetSite-Methode aufgerufen werden soll.

[in] riid

Typ: REFIID

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

[out] ppv

Typ: VOID**

Die Adresse des Zeigers, um den angeforderten Schnittstellenzeiger zu empfangen. Wenn der Funktionsaufruf erfolgreich ist, enthält ppvSite den angeforderten Schnittstellenzeiger. Wenn keine Website verfügbar ist oder die angeforderte Schnittstelle nicht unterstützt wird, wird ppvSite auf NULL festgelegt, und die Funktion gibt einen COM-Fehlercode zurück.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn die Website erfolgreich abgerufen wurde, oder andernfalls ein COM-Fehlercode.

Hinweise

Diese Funktion ruft die QueryInterface-Methode des angegebenen Objekts auf, um die IObjectWithSite-Schnittstelle abzurufen. Bei erfolgreicher Ausführung ruft die Funktion die IObjectWithSite::GetSite-Methode der Schnittstelle auf, um die Website abzurufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server, Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
DLL Shlwapi.dll (Version 5.0 oder höher)