Funzione CoGetObjectContext (combaseapi.h)

  • Articolo

Restituisce il contesto per l'oggetto corrente.

Sintassi

HRESULT CoGetObjectContext(
  [in]  REFIID riid,
  [out] LPVOID *ppv
);

Parametri

[in] riid

Riferimento all'ID di un'interfaccia implementata nell'oggetto contesto.

Per gli oggetti in esecuzione all'interno di applicazioni COM, sono disponibili IID_IComThreadingInfo, IID_IContext e IID_IContextCallback.

Per gli oggetti in esecuzione all'interno di applicazioni COM+, sono disponibili IID_IObjectContext, IID_IObjectContextActivity IID_IObjectContextInfo e IID_IContextState.

[out] ppv

Indirizzo di un puntatore all'interfaccia specificata da riid nell'oggetto di contesto.

Valore restituito

Questa funzione può restituire i valori restituiti standard E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.

Codice restituito Descrizione
S_OK
 Il contesto dell'oggetto è stato recuperato correttamente.
E_NOINTERFACE
 L'interfaccia richiesta non era disponibile.
CO_E_NOTINITIALIZED
 Prima di poter chiamare questa funzione, è necessario chiamare la funzione CoInitializeEx nel thread corrente.

Commenti

CoGetObjectContext recupera il contesto per l'oggetto da cui viene chiamato e restituisce un puntatore a un'interfaccia che può essere utilizzata per modificare le proprietà del contesto. Le proprietà di contesto vengono usate per fornire servizi ai componenti configurati in esecuzione all'interno di applicazioni COM+.

Per i componenti in esecuzione all'interno di applicazioni COM, le interfacce seguenti sono supportate per l'accesso alle proprietà del contesto: IComThreadingInfo, IContext e IContextCallback.

Per i componenti in esecuzione all'interno di applicazioni COM+, sono supportate le interfacce seguenti per l'accesso alle proprietà del contesto: IObjectContext, IObjectContextActivity, IObjectContextInfo e IContextState.

Requisiti

Requisito Valore
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 combaseapi.h (include Objbase.h)
Libreria Ole32.lib
DLL Ole32.dll

Vedi anche

Contesti e modelli di threading