mmioRename

The mmioRename function renames the specified file.

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

Parameters

szFilename

Address of a string containing the filename of the file to rename.

szNewFileName

Address of a string containing the new filename.

lpmmioinfo

Address of 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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in mmsystem.h.
  Import Library: Use winmm.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Multimedia File I/O Overview, Multimedia File I/O Functions, MMIOINFO