mmioRenameW, fonction (mmiscapi.h)

Article
11/20/2024

La fonction mmioRename renomme le fichier spécifié.

Syntaxe

MMRESULT mmioRenameW(
  LPCWSTR     pszFileName,
  LPCWSTR     pszNewFileName,
  LPCMMIOINFO pmmioinfo,
  DWORD       fdwRename
);

Paramètres

pszFileName

Pointeur vers une chaîne contenant le nom de fichier 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 doit avoir la valeur 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 de retour

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

Remarques

Note

L’en-tête mmiscapi.h définit mmioRename comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	mmiscapi.h (include Mmiscapi.h, Windows.h)
bibliothèque	Winmm.lib
DLL	Winmm.dll

Partager via