IBindCtx::GetRunningObjectTable-Methode (objidl.h)

Ruft einen Schnittstellenzeiger auf die ausgeführte Objekttabelle (ROT) für den Computer ab, auf dem dieser Bindungskontext ausgeführt wird.

Syntax

HRESULT GetRunningObjectTable(
  [out] IRunningObjectTable **pprot
);

Parameter

[out] pprot

Die Adresse einer IRunningObjectTable*-Zeigervariable, die den Schnittstellenzeiger auf die ausgeführte Objekttabelle empfängt. Wenn ein Fehler auftritt, wird *pprot auf NULL festgelegt. Wenn *pprot nicht NULL ist, ruft die Implementierung AddRef für das ausgeführte Tabellenobjekt auf. Es liegt in der Verantwortung des Aufrufers , Release aufzurufen.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_OUTOFMEMORY, E_UNEXPECTED und S_OK zurückgeben.

Hinweise

Die ausgeführte Objekttabelle ist eine tabelle, auf die auf jedem Computer global zugegriffen werden kann. Es verfolgt alle Objekte, die derzeit auf dem Computer ausgeführt werden.

Hinweise für Anrufer

In der Regel rufen diejenigen, die eine neue Moniker-Klasse (über eine Implementierung der IMoniker-Schnittstelle ) implementieren , GetRunningObjectTable auf. Es ist nützlich, diese Methode in einer Implementierung von IMoniker::BindToObject oder IMoniker::IsRunning aufzurufen, um zu überprüfen, ob ein Objekt gerade ausgeführt wird. Sie können diese Methode auch in der Implementierung von IMoniker::GetTimeOfLastChange aufrufen, um zu erfahren, wann ein ausgeführtes Objekt zuletzt geändert wurde.

Moniker-Implementierungen sollten diese Methode aufrufen, anstatt die GetRunningObjectTable-Funktion zu verwenden. Dadurch können zukünftige Implementierungen von IBindCtx das Bindungsverhalten ändern.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	objidl.h

Weitere Informationen

Ibindctx

Imoniker

Irunningobjecttable