Metodo IContextCallback::ContextCallback (ctxtcall.h)

Articolo
08/22/2023

Immette il contesto dell'oggetto, esegue la funzione specificata e restituisce.

Sintassi

HRESULT ContextCallback(
  [in] PFNCONTEXTCALL pfnCallback,
  [in] ComCallData    *pParam,
  [in] REFIID         riid,
  [in] int            iMethod,
  [in] IUnknown       *pUnk
);

Parametri

[in] pfnCallback

Funzione da chiamare all'interno del contesto dell'oggetto.

[in] pParam

I dati da passare alla funzione quando vengono chiamati nel contesto.

[in] riid

ID della chiamata simulata. Per ulteriori informazioni, vedere la sezione Osservazioni.

[in] iMethod

Numero di metodo della chiamata simulata. Per ulteriori informazioni, vedere la sezione Osservazioni.

[in] pUnk

Questo parametro è riservato e deve essere NULL.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED e E_FAIL. Se nessuno di questi errori si verifica, il valore restituito di questa funzione è il valore HRESULT restituito dalla funzione pfnCallback .

Commenti

Questo metodo simula una chiamata al metodo su un oggetto all'interno del contesto. È destinato a operazioni di basso livello, ad esempio il marshalling pulizia/lazy, che rispettano le aspettative di reentrancy dell'applicazione.

Per fornire le informazioni sull'infrastruttura, è necessario specificare un numero di interfaccia e metodo. Il riid del parametro non deve essere IID_IUnknown e il numero di metodo non deve essere minore di 3.

Se riid è impostato su IID_IEnterActivityWithNoLock, la funzione viene eseguita senza un blocco attività.

Se riid è impostato su IID_ICallbackWithNoReentrancyToApplicationSTA, la funzione non rientra in modo arbitrario. La maggior parte delle app deve impostare riid su questi valori per l'uso generico.

Requisiti


Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	ctxtcall.h

Vedi anche

IContextCallback

Condividi tramite