Método ILayoutStorage::BeginMonitor (objidl.h)
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 |