IObjectWithSite ::GetSite, méthode (ocidl.h)

Article
02/29/2024

Récupère le dernier site passé à l’aide de SetSite.

Syntaxe

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

Paramètres

[in] riid

IID du pointeur d’interface qui doit être retourné dans ppvSite.

[out] ppvSite

Adresse de la variable pointeur qui reçoit le pointeur d’interface demandé dans riid. Une fois le retour réussi, *ppvSite contient le pointeur d’interface demandé vers le site vu pour la dernière fois dans SetSite. L’interface spécifique retournée dépend de l’argument riid . En substance, les deux arguments agissent de manière identique à ceux de QueryInterface. Si le pointeur d’interface approprié est disponible, l’objet doit appeler AddRef sur ce pointeur avant de retourner correctement. Si aucun site n’est disponible ou si l’interface demandée n’est pas prise en charge, cette méthode doit *ppvSite sur NULL et retourner un code d’échec.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Code de retour	Description
E_FAIL	Il n’existe aucun site, auquel cas *ppvSite contient NULL au retour.
E_NOINTERFACE	Il existe un site, mais il ne prend pas en charge l’interface demandée par riid.

Remarques

E_NOTIMPL n’est pas autorisé. Tout objet implémentant cette interface doit être en mesure de retourner le dernier site vu dans IObjectWithSite ::SetSite.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ocidl.h

Voir aussi

IObjectWithSite

Partager via