Compartilhar via


Para interromper a indexação em andamento

[O recurso associado a esta página, Windows Media Format 11 SDK, é um recurso herdado. Ele foi substituído por Leitor de Origem e Gravador de Coletor. O Leitor de Origem e o Gravador de Coletor foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o Leitor de Origem e o Gravador de Coletor em vez do SDK do Windows Media Format 11, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Depois de começar a indexar com uma chamada para IWMIndexer::StartIndexing, o indexador normalmente continuará até que o arquivo seja indexado. Você pode parar as operações de indexação chamando o método IWMIndexer::Cancel . Depois de cancelar a indexação, você pode chamar StartIndexing novamente, mas o indexador começará desde o início do arquivo em vez de retomar do ponto de cancelamento.

Como StartIndexing é uma chamada assíncrona, você normalmente precisará chamar Cancelar de algum outro thread ou manipulador de eventos em seu aplicativo. Normalmente , Cancel será chamado de um procedimento de evento associado a um controle de botão de um aplicativo do Windows.

Quando a indexação for cancelada, o indexador passará uma mensagem status de WMT_CLOSED, assim como se o arquivo tivesse sido indexado corretamente.

IWMIndexer Interface

Trabalhando com índices