Funzione GetRunningObjectTable (objbase.h)

Restituisce un puntatore all'interfaccia IRunningObjectTable nella tabella di oggetti in esecuzione locale (ROT).

Sintassi

HRESULT GetRunningObjectTable(
  [in]  DWORD                reserved,
  [out] LPRUNNINGOBJECTTABLE *pprot
);

Parametri

[in] reserved

Questo parametro è riservato e deve essere 0.

[out] pprot

Indirizzo di una variabile puntatore IRunningObjectTable* che riceve il puntatore dell'interfaccia al ROT locale. Quando la funzione ha esito positivo, il chiamante è responsabile della chiamata a Release sul puntatore dell'interfaccia. Se si verifica un errore, *pprot non è definito.

Valore restituito

Questa funzione può restituire i valori restituiti standard E_UNEXPECTED e S_OK.

Commenti

Ogni workstation dispone di un ROT locale che gestisce una tabella degli oggetti registrati come in esecuzione nel computer. Questa funzione restituisce un puntatore all'interfaccia IRunningObjectTable , che fornisce l'accesso a tale tabella.

I provider di moniker, che consentono di distribuire moniker che identificano gli oggetti in modo che siano accessibili ad altri, devono chiamare GetRunningObjectTable. Usare il puntatore di interfaccia restituito da questa funzione per registrare gli oggetti quando iniziano l'esecuzione, per registrare i tempi di modifica di tali oggetti e per revocare le registrazioni quando si arresta l'esecuzione. Per altre informazioni, vedere l'interfaccia IRunningObjectTable .

Le origini di collegamento a documenti composti sono l'esempio più comune di provider di moniker. Queste includono applicazioni server che supportano il collegamento ai documenti (o parti di un documento) e alle applicazioni contenitore che supportano il collegamento a incorporamenti all'interno dei documenti. Le applicazioni server che non supportano il collegamento possono anche usare rot per collaborare con le applicazioni contenitore che supportano il collegamento a incorporamenti.

Se si implementa l'interfaccia IMoniker per scrivere una nuova classe moniker ed è necessario un puntatore all'interfaccia ROT, chiamare IBindCtx::GetRunningObjectTable anziché la funzione GetRunningObjectTable . In questo modo, le implementazioni future dell'interfaccia IBindCtx possono modificare il comportamento di associazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	objbase.h
Libreria	Ole32.lib
DLL	Ole32.dll
Set di API	ext-ms-win-com-ole32-l1-1-0 (introdotto in Windows 8)

Vedi anche

IBindCtx::GetRunningObjectTable

Imoniker

IRunningObjectTable