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) |