Compartir a través de


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

El método Rename cambia el nombre del almacenamiento actual.

Sintaxis

HRESULT Rename(
  [in] UINT          fuMode,
  [in] LPWSTR        pwszNewName,
  [in] IWMDMProgress *pProgress
);

Parámetros

[in] fuMode

Modo de procesamiento utilizado para la operación Cambiar nombre . Especifique exactamente uno de los dos modos siguientes. Si se especifican ambos modos, 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 devolverá inmediatamente y la operación se realiza en un subproceso en segundo plano.

[in] pwszNewName

Puntero a una cadena terminada en null de caracteres anchos que especifica el nuevo nombre.

[in] pProgress

Puntero opcional a una interfaz IWMDMProgress implementada por la aplicación para realizar un seguimiento del progreso de la acció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.

Si una aplicación usa WMDM_MODE_THREAD y pasa un parámetro pProgress distinto de 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 end. Si no lo hace, se producirán infracciones de acceso.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado mswmdm.h
Library Mssachlp.lib

Consulte también

IWMDMDevice::GetStatus

Interfaz IWMDMProgress

Interfaz IWMDMStorage

IWMDMStorage::GetName

Interfaz IWMDMStorageControl