Fonction LresultFromObject (oleacc.h)

Retourne une référence, similaire à un handle, à l’objet spécifié. Les serveurs retournent cette référence lors de la gestion des WM_GETOBJECT.

Syntaxe

LRESULT LresultFromObject(
  [in] REFIID    riid,
  [in] WPARAM    wParam,
  [in] LPUNKNOWN punk
);

Paramètres

[in] riid

Type : REFIID

Identificateur de référence de l’interface fournie au client. Ce paramètre est IID_IAccessible.

[in] wParam

Type : WPARAM

Valeur envoyée par le message WM_GETOBJECT associé dans son paramètre wParam .

[in] punk

Type : LPUNKNOWN

Adresse de l’interface IAccessible à l’objet qui correspond au message WM_GETOBJECT .

Valeur retournée

Type : LRESULT

En cas de réussite, retourne une valeur positive qui est une référence à l’objet.

En cas de non-réussite, retourne l’une des valeurs de la table qui suit ou un autre code d’erreur COM standard.

Code de retour	Description
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
E_NOINTERFACE	L’objet spécifié dans le paramètre pAcc ne prend pas en charge l’interface spécifiée dans le paramètre riid .
E_OUTOFMEMORY	Mémoire insuffisante pour stocker la référence d’objet.
E_UNEXPECTED	Une erreur inattendue s’est produite.

Remarques

Les serveurs appellent cette fonction uniquement lors de la gestion du message WM_GETOBJECT . Pour obtenir une vue d’ensemble de la façon dont LresultFromObject est lié à WM_GETOBJECT, consultez Fonctionnement WM_GETOBJECT.

LresultFromObject incrémente le nombre de références de l’objet. Si vous ne stockez pas le pointeur d’interface passé à la fonction (autrement dit, vous créez un pointeur d’interface pour l’objet chaque fois que WM_GETOBJECT est reçu), appelez la méthode Release de l’objet pour décrémenter le nombre de références. Ensuite, le client appelle Release et l’objet est détruit. Pour plus d’informations, consultez Comment gérer WM_GETOBJECT.

Chaque fois qu’un serveur traite WM_GETOBJECT pour un objet spécifique, il appelle LresultFromObject pour obtenir une nouvelle référence à l’objet. Les serveurs n’enregistrent pas la référence retournée par LresultFromObject à partir d’un instance de traitement WM_GETOBJECT à utiliser comme valeur de retour du message lors du traitement des messages WM_GETOBJECT suivants pour le même objet. Cela entraîne la réception d’une erreur par le client.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oleacc.h
Bibliothèque	Oleacc.lib
DLL	Oleacc.dll
Composant redistribuable	Active Accessibility 1.3 RDK sur Windows NT 4.0 avec SP6 et versions ultérieures et Windows 95

Voir aussi

Création d’objets proxy

Fonctionnement de WM_GETOBJECT

Comment gérer les WM_GETOBJECT

WM_GETOBJECT