mmioRename

The mmioRename function renames the specified file.

MMRESULT mmioRename(
  LPCTSTR szFilename,            
  LPCTSTR szNewFilename,         
  const LPMMIOINFO lpmmioinfo,  
  DWORD dwRenameFlags           
);

Parameters

szFilename

Pointer to a string containing the file name of the file to rename.

szNewFilename

Pointer to a string containing the new file name.

lpmmioinfo

Pointer to an MMIOINFO structure containing extra parameters used by mmioRename. If this parameter is not NULL, all unused members of the MMIOINFO structure it references must be set to zero, including the reserved members.

dwRenameFlags

Flags for the rename operation. This parameter should be set to zero.

Return Values

Returns zero if the file was renamed. Otherwise, returns an error code returned from mmioRename or from the I/O procedure.

Requirements

  Windows NT/2000/XP: Included in Windows NT 3.1 and later.
  Windows 95/98/Me: Included in Windows 95 and later.
  Header: Declared in Mmsystem.h; include Windows.h.
  Library: Use Winmm.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000/XP.

See Also

MMIOINFO

Show: