Método IWMDMStorageControl::D elete (mswmdm.h)

Artigo
02/29/2024

O método Delete exclui permanentemente esse armazenamento.

Sintaxe

HRESULT Delete(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress
);

Parâmetros

[in] fuMode

Um ou dois dos sinalizadores a seguir, combinados com um OR bit a bit. Especifique exatamente um dos dois primeiros modos; o terceiro modo é opcional.

Mode	Descrição
WMDM_MODE_BLOCK	A operação é executada usando o processamento do modo de bloqueio (síncrono). A chamada não retornará até que a operação seja concluída.
WMDM_MODE_THREAD	A operação é executada usando o processamento do modo de thread (assíncrono). A chamada retornará imediatamente e a operação será executada em um thread em segundo plano.
WMDM_MODE_RECURSIVE	Se o objeto de armazenamento for uma pasta, ele e seu conteúdo e todas as subpastas e seu conteúdo serão excluídos.

[in] pProgress

Ponteiro opcional para uma interface IWMDMProgress a ser usada pelo Windows Media Gerenciador de Dispositivos para relatar o progresso de volta ao aplicativo.

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

Códigos de erro COM padrão
Códigos de erro do Windows convertidos em valores HRESULT
Códigos de erro de Gerenciador de Dispositivos do Windows Media

Para obter uma ampla lista de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Se o sinalizador WMDM_MODE_THREAD for especificado, você deverá obter status de conclusão chamando IWMDMProgress2::End2 ou IWMDMProgress3::End3. Esses métodos garantirão que a operação seja concluída e também retornarão um HRESULT com informações de êxito ou falha.

Quando a operação Delete for concluída, todas as referências ao objeto excluído se tornarão inválidas. O aplicativo deve liberar essas interfaces e quaisquer outras interfaces ou recursos associados ao objeto .

Se um aplicativo usa WMDM_MODE_THREAD e passa um parâmetro pProgress não nulo, o aplicativo deve garantir que o objeto ao qual o pProgress pertence não seja destruído até que a operação de exclusão seja concluída, pois o Windows Media Gerenciador de Dispositivos enviará notificações de progresso para esse objeto. Esse objeto só pode ser destruído depois de receber uma notificação End. A falha ao fazer isso resultará em violações de acesso.