fonction mmioRenameA (mmiscapi.h)

Article
02/29/2024

La fonction mmioRename renomme le fichier spécifié.

Syntaxe

MMRESULT mmioRenameA(
  LPCSTR      pszFileName,
  LPCSTR      pszNewFileName,
  LPCMMIOINFO pmmioinfo,
  DWORD       fdwRename
);

Paramètres

pszFileName

Pointeur vers une chaîne contenant le nom du fichier à renommer.

pszNewFileName

Pointeur vers une chaîne contenant le nouveau nom de fichier.

pmmioinfo

Pointeur vers une structure MMIOINFO contenant des paramètres supplémentaires utilisés par mmioRename. Si ce paramètre n’est pas NULL, tous les membres inutilisés de la structure MMIOINFO qu’il référence doivent être définis sur zéro, y compris les membres réservés.

fdwRename

Indicateurs pour l’opération de renommage. Ce paramètre doit être défini sur zéro.

Valeur retournée

Retourne zéro si le fichier a été renommé. Sinon, retourne un code d’erreur retourné à partir de mmioRename ou de la procédure d’E/S.

Remarques

Notes

L’en-tête mmiscapi.h définit mmioRename en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mmiscapi.h (inclure Mmiscapi.h, Windows.h)
Bibliothèque	Winmm.lib
DLL	Winmm.dll

Partager via