Método ILayoutStorage::BeginMonitor (objidl.h)

  • Artigo

O método BeginMonitor é usado para iniciar o monitoramento quando uma operação de carregamento é iniciada. Quando a operação for concluída, o aplicativo deverá chamar ILayoutStorage::EndMonitor.

Sintaxe

HRESULT BeginMonitor();

Retornar valor

Esse método dá suporte aos valores retornados padrão E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG e E_FAIL, bem como o seguinte:

Código de retorno Descrição
STG_E_INUSE BeginMonitor foi chamado enquanto ILayoutStorage já estava monitorando.

Comentários

Normalmente, um aplicativo chama BeginMonitor antes do início do carregamento real. Depois que esse método for chamado, a implementação do arquivo composto considerará qualquer operação executada nos armazenamentos e fluxos de arquivos como parte do padrão de acesso desejado. O resultado é um script de layout como aquele criado explicitamente chamando ILayoutStorage::LayoutScript.

Os aplicativos geralmente usarão o monitoramento para obter o padrão de acesso de objetos inseridos. O monitoramento também possibilita ferramentas de layout genéricas, que iniciam aplicativos existentes e monitoram seus padrões de acesso.

Uma chamada para ILayoutStorage::EndMonitor encerra o monitoramento. Várias chamadas para BeginMonitor e EndMonitor são permitidas. O monitoramento também pode ser misturado com chamadas para ILayoutStorage::LayoutScript.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho objidl.h
Biblioteca Uuid.lib
DLL Ole32.dll

Confira também

ILayoutStorage::EndMonitor

ILayoutStorage::LayoutScript