GetRunningObjectTable-Funktion (objbase.h)

  • Artikel

Gibt einen Zeiger auf die IRunningObjectTable-Schnittstelle in der lokalen ausgeführten Objekttabelle (ROT) zurück.

Syntax

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

Parameter

[in] reserved

Dieser Parameter ist reserviert und muss 0 sein.

[out] pprot

Die Adresse einer IRunningObjectTable*-Zeigervariable, die den Schnittstellenzeiger auf den lokalen ROT empfängt. Wenn die Funktion erfolgreich ist, ist der Aufrufer für den Aufruf von Release auf dem Schnittstellenzeiger verantwortlich. Wenn ein Fehler auftritt, ist *pprot nicht definiert.

Rückgabewert

Diese Funktion kann die standardmäßigen Rückgabewerte E_UNEXPECTED und S_OK zurückgeben.

Hinweise

Jede Arbeitsstation verfügt über eine lokale ROT-Datei, die eine Tabelle der Objekte verwaltet, die auf diesem Computer als ausgeführt registriert wurden. Diese Funktion gibt einen IRunningObjectTable-Schnittstellenzeiger zurück, der Zugriff auf diese Tabelle ermöglicht.

Moniker-Anbieter, die Moniker verteilen, die Objekte identifizieren, damit sie für andere zugänglich sind, sollten GetRunningObjectTable aufrufen. Verwenden Sie den von dieser Funktion zurückgegebenen Schnittstellenzeiger, um Ihre Objekte zu registrieren, wenn sie mit der Ausführung beginnen, um die Zeiten aufzuzeichnen, zu denen diese Objekte geändert werden, und um ihre Registrierungen zu widerrufen, wenn sie nicht mehr ausgeführt werden. Weitere Informationen finden Sie unter der IRunningObjectTable-Schnittstelle .

Verbunddokumentlinkquellen sind das häufigste Beispiel für Monikeranbieter. Dazu gehören Serveranwendungen, die das Verknüpfen mit ihren Dokumenten (oder Teilen eines Dokuments) unterstützen, und Containeranwendungen, die das Verknüpfen von Einbettungen in ihre Dokumente unterstützen. Serveranwendungen, die verknüpfungen nicht unterstützen, können auch rot verwenden, um mit Containeranwendungen zusammenzuarbeiten, die das Verknüpfen mit Einbettungen unterstützen.

Wenn Sie die IMoniker-Schnittstelle implementieren, um eine neue Monikerklasse zu schreiben, und Sie einen Schnittstellenzeiger auf rot benötigen, rufen Sie IBindCtx::GetRunningObjectTable anstelle der GetRunningObjectTable-Funktion auf. Dadurch können zukünftige Implementierungen der IBindCtx-Schnittstelle das Bindungsverhalten ändern.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile objbase.h
Bibliothek Ole32.lib
DLL Ole32.dll
APIs ext-ms-win-com-ole32-l1-1-0 (eingeführt in Windows 8)

Weitere Informationen

IBindCtx::GetRunningObjectTable

Imoniker

Irunningobjecttable