Metodo ILayoutStorage::BeginMonitor (objidl.h)

Il metodo BeginMonitor viene utilizzato per avviare il monitoraggio all'avvio di un'operazione di caricamento. Al termine dell'operazione, l'applicazione deve chiamare ILayoutStorage::EndMonitor.

Sintassi

HRESULT BeginMonitor();

Valore restituito

Questo metodo supporta i valori restituiti standard E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG e E_FAIL, nonché i seguenti:

Codice restituito	Descrizione
STG_E_INUSE	BeginMonitor è stato chiamato durante il monitoraggio di ILayoutStorage .

Commenti

In genere un'applicazione chiama BeginMonitor prima che inizi il caricamento effettivo. Una volta chiamato questo metodo, l'implementazione del file composto considera qualsiasi operazione eseguita negli archivi e nei flussi dei file come parte del modello di accesso desiderato. Il risultato è uno script di layout simile a quello creato in modo esplicito chiamando ILayoutStorage::LayoutScript.

Le applicazioni usano in genere il monitoraggio per ottenere il modello di accesso di oggetti incorporati. Il monitoraggio rende inoltre possibili strumenti di layout generici, che avviano applicazioni esistenti e monitorano i modelli di accesso.

Una chiamata a ILayoutStorage::EndMonitor termina il monitoraggio. Sono consentite più chiamate a BeginMonitor e EndMonitor . Il monitoraggio può anche essere combinato con le chiamate a ILayoutStorage::LayoutScript.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	objidl.h
Libreria	Uuid.lib
DLL	Ole32.dll

Vedi anche

ILayoutStorage::EndMonitor

ILayoutStorage::LayoutScript