ILayoutStorage::BeginMonitor-Methode (objidl.h)

Die BeginMonitor-Methode wird verwendet, um mit der Überwachung zu beginnen, wenn ein Ladevorgang gestartet wird. Wenn der Vorgang abgeschlossen ist, muss die Anwendung ILayoutStorage::EndMonitor aufrufen.

Syntax

HRESULT BeginMonitor();

Rückgabewert

Diese Methode unterstützt die Standardrückgabewerte E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG und E_FAIL sowie Folgendes:

Rückgabecode	Beschreibung
STG_E_INUSE	BeginMonitor wurde aufgerufen, während ILayoutStorage bereits überwacht wurde.

Hinweise

Normalerweise ruft eine Anwendung BeginMonitor auf, bevor das eigentliche Laden beginnt. Nachdem diese Methode aufgerufen wurde, betrachtet die Verbunddateiimplementierung alle Vorgänge, die für die Dateispeicher und -streams ausgeführt werden, als Teil des gewünschten Zugriffsmusters. Das Ergebnis ist ein Layoutskript wie das, das explizit durch Aufrufen von ILayoutStorage::LayoutScript erstellt wird.

Anwendungen verwenden in der Regel die Überwachung, um das Zugriffsmuster eingebetteter Objekte abzurufen. Die Überwachung ermöglicht auch generische Layouttools, die vorhandene Anwendungen starten und deren Zugriffsmuster überwachen.

Ein Aufruf von ILayoutStorage::EndMonitor beendet die Überwachung. Mehrere Aufrufe von BeginMonitor und EndMonitor sind zulässig. Die Überwachung kann auch mit Aufrufen von ILayoutStorage::LayoutScript kombiniert werden.

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
Bibliothek	Uuid.lib
DLL	Ole32.dll

Weitere Informationen

ILayoutStorage::EndMonitor

ILayoutStorage::LayoutScript