Funzione mmioRenameW (mmiscapi.h)

Articolo
11/20/2024

La funzione mmioRename rinomina il file specificato.

Sintassi

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

Parametri

pszFileName

Puntatore a una stringa contenente il nome file del file da rinominare.

pszNewFileName

Puntatore a una stringa contenente il nuovo nome file.

pmmioinfo

Puntatore a una struttura MMIOINFO contenente parametri aggiuntivi utilizzati da mmioRename. Se questo parametro non è NULL, tutti i membri inutilizzati del MMIOINFO struttura a cui fa riferimento devono essere impostati su zero, inclusi i membri riservati.

fdwRename

Flag per l'operazione di ridenominazione. Questo parametro deve essere impostato su zero.

Valore restituito

Restituisce zero se il file è stato rinominato. In caso contrario, restituisce un codice di errore restituito da mmioRename o dalla routine di I/O.

Osservazioni

Nota

L'intestazione mmiscapi.h definisce mmioRename come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	mmiscapi.h (include Mmiscapi.h, Windows.h)
libreria	Winmm.lib
dll	Winmm.dll

Condividi tramite