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 |