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

Artigo
03/05/2024

O método Rename renomeia o armazenamento atual.

Sintaxe

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

Parâmetros

[in] fuMode

Modo de processamento usado para a operação Renomear . Especifique exatamente um dos dois modos a seguir. Se ambos os modos forem especificados, o modo de bloco será usado.

Mode	Descrição
WMDM_MODE_BLOCK	A operação é executada usando o processamento do modo de bloco. A chamada não retornará até que a operação seja concluída.
WMDM_MODE_THREAD	A operação é executada usando o processamento do modo thread. A chamada retornará imediatamente e a operação será executada em um thread em segundo plano.

[in] pwszNewName

Ponteiro para uma cadeia de caracteres largos terminada em nulo especificando o novo nome.

[in] pProgress

Ponteiro opcional para uma interface IWMDMProgress que foi implementada pelo aplicativo para acompanhar o progresso da ação.

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

Códigos de erro COM padrão
Códigos de erro do Windows convertidos em valores HRESULT
Códigos de erro de Gerenciador de Dispositivos do Windows Media

Para obter uma ampla lista de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Se o sinalizador WMDM_MODE_THREAD for especificado, você deverá obter status de conclusão chamando IWMDMProgress2::End2 ou IWMDMProgress3::End3. Esses métodos garantirão que a operação seja concluída e também retornarão um HRESULT com informações de êxito ou falha.

Se um aplicativo usa WMDM_MODE_THREAD e passa um parâmetro pProgress não nulo, o aplicativo deve garantir que o objeto ao qual o pProgress pertence não seja destruído até que a operação de leitura seja concluída, pois o Windows Media Gerenciador de Dispositivos enviará notificações de progresso para esse objeto. Esse objeto só pode ser destruído depois de receber uma notificação End. A falha ao fazer isso resultará em violações de acesso.