Método IWMDMStorageControl::Read (mswmdm.h)

Artículo
02/29/2024

El método Read copia el almacenamiento actual en el equipo.

Sintaxis

HRESULT Read(
  [in] UINT           fuMode,
  [in] LPWSTR         pwszFile,
  [in] IWMDMProgress  *pProgress,
  [in] IWMDMOperation *pOperation
);

Parámetros

[in] fuMode

Modo de procesamiento usado para la operación de lectura . En la tabla siguiente se enumeran los modos de procesamiento que se pueden especificar en el parámetro fuMode . Debe especificar exactamente uno de los dos primeros modos y exactamente uno de los tres últimos (WMDM_CONTENT). Si se especifican WMDM_MODE_BLOCK y WMDM_MODE_THREAD, se usa el modo de bloque.

Mode	Descripción
WMDM_MODE_BLOCK	La operación se realiza mediante el procesamiento del modo de bloque. 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. La llamada se devolverá inmediatamente y la operación se realiza en un subproceso en segundo plano.
WMDM_CONTENT_FILE	El autor de la llamada solicita que Windows Media Administrador de dispositivos leer el archivo del dispositivo portátil en un archivo del disco duro. El llamador debe indicar, en el parámetro pwszFileName , la ruta de acceso completa y el nombre del archivo.
WMDM_CONTENT_FOLDER	El autor de la llamada solicita que Windows Media Administrador de dispositivos leer la carpeta especificada, el contenido de la carpeta y el contenido de las subcarpetas del dispositivo portátil en el disco duro. El autor de la llamada debe indicar la ruta de acceso completa del directorio de destino en el disco duro en el parámetro pwszFileName . Actualmente no es compatible con ningún proveedor de servicios proporcionado por Microsoft.
WMDM_CONTENT_OPERATIONINTERFACE	La interfaz IWMDMOperation implementada por la aplicación se usa para leer datos, en lugar de pasar un nombre de archivo.

[in] pwszFile

Puntero a un nombre de archivo completo en el equipo en el que se copia el contenido del dispositivo portátil. El nombre de archivo debe incluir una extensión; No se usará la extensión del almacenamiento actual en el dispositivo. Si WMDM_CONTENT_OPERATIONINTERFACE se especifica en fuMode, se omite este parámetro.

[in] pProgress

Puntero opcional a una interfaz IWMDMProgress implementada por la aplicación para realizar un seguimiento del progreso de las operaciones en curso.

[in] pOperation

Puntero opcional a una interfaz IWMDMOperation , un conjunto opcional de métodos que se usan para mejorar la transferencia de contenido desde un dispositivo multimedia. Este parámetro debe ser NULL si se especifica WMDM_CONTENT_FILE o WMDM_CONTENT_FOLDER en fuMode.

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

Este método sobrescribirá automáticamente los archivos existentes especificados por pwszFilename. Se puede realizar correctamente incluso si

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.

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 lectura, 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.