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

Artículo
02/29/2024

El método Delete elimina permanentemente este almacenamiento.

Sintaxis

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

Parámetros

[in] fuMode

Una o dos de las marcas siguientes, combinadas con un OR bit a bit. Especifique exactamente uno de los dos primeros modos; el tercer modo es opcional.

Mode	Descripción
WMDM_MODE_BLOCK	La operación se realiza mediante el procesamiento del modo de bloque (sincrónico). La llamada no se devolverá hasta que finalice la operación.
WMDM_MODE_THREAD	La operación se realiza mediante el procesamiento del modo de subproceso (asincrónico). La llamada se devolverá inmediatamente y la operación se realiza en un subproceso en segundo plano.
WMDM_MODE_RECURSIVE	Si el objeto de almacenamiento es una carpeta, éste y su contenido, y todas las subcarpetas y su contenido se eliminan.

[in] pProgress

Puntero opcional a una interfaz IWMDMProgress que windows Media Administrador de dispositivos usar para informar del progreso a la aplicación.

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:

Códigos de error COM estándar
Códigos de error de Windows convertidos en valores HRESULT
Códigos de error de windows Media Administrador de dispositivos

Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

Si se especifica la marca WMDM_MODE_THREAD, debe obtener el estado de finalización llamando a IWMDMProgress2::End2 o IWMDMProgress3::End3. Estos métodos garantizarán que la operación está completa y también devolverán un HRESULT con información de éxito o error.

Una vez finalizada la operación Delete , todas las referencias al objeto eliminado no son válidas. La aplicación debe liberar estas interfaces y cualquier otra interfaz o recursos asociados al objeto .

Si una aplicación usa WMDM_MODE_THREAD y pasa un parámetro pProgress no null, la aplicación debe asegurarse de que el objeto al que pertenece pProgress no se destruye hasta que se complete la operación de eliminación, ya que Windows Media Administrador de dispositivos enviará notificaciones de progreso a este objeto. Este objeto solo se puede destruir después de recibir una notificación de finalización. Si no lo hace, se producirán infracciones de acceso.