Funzione LresultFromObject (oleacc.h)

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.

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

Vedi anche

Creazione di oggetti proxy

Funzionamento WM_GETOBJECT

Come gestire WM_GETOBJECT

WM_GETOBJECT