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
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 |