Funzione LresultFromObject (oleacc.h)

Articolo
03/05/2024

Restituisce un riferimento, simile a un handle, all'oggetto specificato. I server restituiscono questo riferimento durante la gestione di WM_GETOBJECT.

Sintassi

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

Parametri

[in] riid

Tipo: REFIID

Identificatore di riferimento dell'interfaccia fornita al client. Questo parametro è IID_IAccessible.

[in] wParam

Tipo: WPARAM

Valore inviato dal messaggio di WM_GETOBJECT associato nel relativo parametro wParam .

[in] punk

Tipo: LPUNKNOWN

Indirizzo dell'interfaccia IAccessibile all'oggetto corrispondente al messaggio di WM_GETOBJECT .

Valore restituito

Tipo: LRESULT

In caso di esito positivo, restituisce un valore positivo che è un riferimento all'oggetto.

In caso contrario, restituisce uno dei valori della tabella che segue o un altro codice di errore COM standard.

Codice restituito	Descrizione
E_INVALIDARG	Uno o più argomenti non sono validi.
E_NOINTERFACE	L'oggetto specificato nel parametro pAcc non supporta l'interfaccia specificata nel parametro riid .
E_OUTOFMEMORY	Memoria insufficiente per archiviare il riferimento all'oggetto.
E_UNEXPECTED	Si è verificato un errore imprevisto.

Commenti

I server chiamano questa funzione solo quando si gestisce il messaggio di WM_GETOBJECT . Per una panoramica del modo in cui LresultFromObject è correlato a WM_GETOBJECT, vedere How WM_GETOBJECT Works.For an overview of how LresultFromObject is related to WM_GETOBJECT, see How WM_GETOBJECT Works.

LresultFromObject incrementa il conteggio dei riferimenti dell'oggetto. Se non si archivia il puntatore dell'interfaccia passato alla funzione , ovvero si crea un nuovo puntatore dell'interfaccia per l'oggetto ogni volta che viene ricevuto WM_GETOBJECT , chiamare il metodo Release dell'oggetto per decrerere il conteggio dei riferimenti a uno. Il client chiama quindi Release e l'oggetto viene distrutto. Per altre informazioni, vedere Come gestire WM_GETOBJECT.

Ogni volta che un server elabora WM_GETOBJECT per un oggetto specifico, chiama LresultFromObject per ottenere un nuovo riferimento all'oggetto. I server non salvano il riferimento restituito da LresultFromObject da un'istanza dell'elaborazione WM_GETOBJECT da usare come valore restituito del messaggio durante l'elaborazione dei messaggi successivi WM_GETOBJECT per lo stesso oggetto. In questo modo il client riceve un errore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oleacc.h
Libreria	Oleacc.lib
DLL	Oleacc.dll
Componente ridistribuibile	Accessibilità attiva 1.3 RDK in Windows NT 4.0 con SP6 e versioni successive e Windows 95

Vedi anche

Creazione di oggetti proxy

Funzionamento WM_GETOBJECT

Come gestire WM_GETOBJECT

WM_GETOBJECT

Condividi tramite