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 |