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

Article
02/29/2024

La méthode Rename renomme le stockage actuel.

Syntaxe

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

Paramètres

[in] fuMode

Mode de traitement utilisé pour l’opération Renommer . Spécifiez exactement l’un des deux modes suivants. Si les deux modes sont spécifiés, le mode bloc est utilisé.

Mode	Description
WMDM_MODE_BLOCK	L’opération est effectuée à l’aide du traitement en mode bloc. L’appel ne sera pas retourné tant que l’opération n’est pas terminée.
WMDM_MODE_THREAD	L’opération est effectuée à l’aide du traitement en mode thread. L’appel est retourné immédiatement et l’opération est effectuée dans un thread d’arrière-plan.

[in] pwszNewName

Pointeur vers une chaîne de caractères larges terminée par un caractère Null spécifiant le nouveau nom.

[in] pProgress

Pointeur facultatif vers une interface IWMDMProgress implémentée par l’application pour suivre la progression de l’action.

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes suivantes de codes d’erreur :

Codes d’erreur COM standard
Codes d’erreur Windows convertis en valeurs HRESULT
Codes d’erreur Gestionnaire de périphériques Windows Media

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Si l’indicateur WMDM_MODE_THREAD est spécifié, vous devez obtenir l’achèvement status en appelant IWMDMProgress2 ::End2 ou IWMDMProgress3 ::End3. Ces méthodes garantissent que l’opération est terminée et retournent également un HRESULT avec des informations de réussite ou d’échec.

Si une application utilise WMDM_MODE_THREAD et passe un paramètre pProgress non null, l’application doit s’assurer que l’objet auquel appartient pProgress n’est pas détruit tant que l’opération de lecture n’est pas terminée, car Windows Media Gestionnaire de périphériques envoie des notifications de progression à cet objet. Cet objet ne peut être détruit qu’après avoir reçu une notification De fin. Si vous ne le faites pas, vous obtiendrez des violations d’accès.