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

Artículo
03/13/2024

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.