Metodo IObjectWithSite::GetSite (ocidl.h)

Articolo
02/29/2024

Recupera il sito più recente passato usando SetSite.

Sintassi

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

Parametri

[in] riid

Id del puntatore dell'interfaccia che deve essere restituito in ppvSite.

[out] ppvSite

Indirizzo della variabile puntatore che riceve il puntatore dell'interfaccia richiesto in riid. Al termine della restituzione, *ppvSite contiene il puntatore dell'interfaccia richiesto all'ultimo sito visualizzato in SetSite. L'interfaccia specifica restituita dipende dall'argomento riid . In sostanza, i due argomenti agiscono in modo identico a quelli in QueryInterface. Se il puntatore dell'interfaccia appropriato è disponibile, l'oggetto deve chiamare AddRef su tale puntatore prima di restituire correttamente. Se non è disponibile alcun sito o l'interfaccia richiesta non è supportata, questo metodo deve *ppvSite to NULL e restituire un codice di errore.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_FAIL	Non esiste alcun sito, in cui *ppvSite contiene NULL in caso di restituzione.
E_NOINTERFACE	Esiste un sito, ma non supporta l'interfaccia richiesta da riid.

Commenti

E_NOTIMPL non è consentito. Qualsiasi oggetto che implementa questa interfaccia deve essere in grado di restituire l'ultimo sito visualizzato in IObjectWithSite::SetSite.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h

Vedi anche

IObjectWithSite

Share via