Share via

IRunningObjectTable::Revoke-Methode (objidl.h)

  • Artikel

Entfernt einen Eintrag aus der ausgeführten Objekttabelle (ROT), der zuvor durch einen Aufruf von IRunningObjectTable::Register registriert wurde.

Syntax

HRESULT Revoke(
  [in] DWORD dwRegister
);

Parameter

[in] dwRegister

Der Bezeichner des zu widerrufenden ROT-Eintrags.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG und S_OK zurückgeben.

Hinweise

Diese Methode hebt die Auswirkung eines Aufrufs von IRunningObjectTable::Register auf, wobei sowohl der Moniker als auch der Zeiger auf das von diesem Moniker identifizierte Objekt entfernt werden.

Hinweise für Anrufer

Ein Monikeranbieter (verteilt Moniker, die seine Objekte identifizieren, um sie für andere zugänglich zu machen) muss die Revoke-Methode aufrufen, um die Registrierung seiner Objekte zu widerrufen, wenn sie nicht mehr ausgeführt wird. Es muss zuvor IRunningObjectTable::Register aufgerufen und den von dieser Methode zurückgegebenen Bezeichner gespeichert haben. Beim Aufrufen von Revoke wird dieser Bezeichner verwendet.

Der am häufigsten verwendete Monikeranbieter ist eine Verbunddokumentverknüpfungsquelle. Dies umfasst 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 keine Verknüpfungen unterstützen, können auch rot verwenden, um mit Containeranwendungen zusammenzuarbeiten, die das Verknüpfen mit Einbettungen unterstützen.

Wenn Sie eine Containeranwendung schreiben, müssen Sie die Registrierung eines Dokuments widerrufen, wenn das Dokument geschlossen wird. Sie müssen auch die Registrierung eines Dokuments widerrufen, bevor Sie es erneut registrieren, wenn es umbenannt wird.

Wenn Sie eine Serveranwendung schreiben, müssen Sie die Registrierung eines Objekts widerrufen, wenn das Objekt geschlossen wird. Sie müssen auch die Registrierung eines Objekts widerrufen, bevor Sie es erneut registrieren, wenn das Containerdokument umbenannt wird (siehe IOleObject::SetMoniker).

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 objidl.h

Weitere Informationen

Irunningobjecttable