Metodo IWMDMStorageControl::D elete (mswmdm.h)

Articolo
03/05/2024

Il metodo Delete elimina definitivamente questa risorsa di archiviazione.

Sintassi

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

Parametri

[in] fuMode

Uno o due dei flag seguenti, combinati con un OR bit per bit. Specificare esattamente una delle prime due modalità; la terza modalità è facoltativa.

Mode	Descrizione
WMDM_MODE_BLOCK	L'operazione viene eseguita usando l'elaborazione in modalità blocco (sincrona). La chiamata non restituirà fino al termine dell'operazione.
WMDM_MODE_THREAD	L'operazione viene eseguita usando l'elaborazione in modalità thread (asincrona). La chiamata restituirà immediatamente e l'operazione viene eseguita in un thread in background.
WMDM_MODE_RECURSIVE	Se l'oggetto di archiviazione è una cartella, e il relativo contenuto e tutte le sottocartelle e il relativo contenuto vengono eliminati.

[in] pProgress

Puntatore facoltativo a un'interfaccia IWMDMProgress da usare da Windows Media Gestione dispositivi per segnalare lo stato di avanzamento all'applicazione.

Valore restituito

Il metodo restituisce un HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

Se viene specificato il flag WMDM_MODE_THREAD, è necessario ottenere lo stato di completamento chiamando IWMDMProgress2::End2 o IWMDMProgress3::End3. Questi metodi assicureranno che l'operazione sia completata e restituirà anche un HRESULT con informazioni sull'esito positivo o negativo.

Al termine dell'operazione Delete , tutti i riferimenti all'oggetto eliminato diventano non validi. L'applicazione deve rilasciare queste interfacce e tutte le altre interfacce o risorse associate all'oggetto.

Se un'applicazione usa WMDM_MODE_THREAD e passa un parametro pProgress diverso da null, l'applicazione deve assicurarsi che l'oggetto a cui appartiene pProgress non venga eliminato finché l'operazione di eliminazione non viene completata, perché Windows Media Gestione dispositivi invierà notifiche di stato a questo oggetto. Questo oggetto può essere eliminato solo dopo la ricezione di una notifica End. Questa operazione comporta violazioni di accesso.