mmioRenameW-Funktion (mmiscapi.h)

Artikel
11/20/2024

Die mmioRename Funktion benennt die angegebene Datei um.

Syntax

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

Parameter

pszFileName

Zeigen Sie auf eine Zeichenfolge, die den Dateinamen der datei enthält, umzubenennen.

pszNewFileName

Zeigen Sie auf eine Zeichenfolge, die den neuen Dateinamen enthält.

pmmioinfo

Zeiger auf eine MMIOINFO- Struktur mit zusätzlichen Parametern, die von mmioRenameverwendet werden. Wenn dieser Parameter nicht NULL-ist, müssen alle nicht verwendeten Member der MMIOINFO- Struktur auf Null festgelegt werden, einschließlich der reservierten Member.

fdwRename

Flags für den Umbenennungsvorgang. Dieser Parameter sollte auf Null festgelegt werden.

Rückgabewert

Gibt Null zurück, wenn die Datei umbenannt wurde. Andernfalls wird ein von mmioRename oder aus der E/A-Prozedur zurückgegebener Fehlercode zurückgegeben.

Bemerkungen

Anmerkung

Der mmiscapi.h-Header definiert mmioRename als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	mmiscapi.h (einschließen Mmiscapi.h, Windows.h)
Library	Winmm.lib
DLL-	Winmm.dll

Freigeben über