Funzione PathRenameExtensionW (shlwapi.h)

Articolo
03/05/2024

Sostituisce l'estensione di un nome file con una nuova estensione. Se il nome del file non contiene un'estensione, l'estensione verrà associata alla fine della stringa.

Nota L'uso improprio di questa funzione può causare un overrun del buffer. È consigliabile usare la funzione PathCchRenameExtension più sicura al suo posto.

Sintassi

BOOL PathRenameExtensionW(
  [in, out] LPWSTR  pszPath,
  [in]      LPCWSTR pszExt
);

Parametri

[in, out] pszPath

Tipo: LPTSTR

Puntatore a una stringa con terminazione null di lunghezza MAX_PATH in cui sostituire l'estensione.

[in] pszExt

Tipo: LPCTSTR

Puntatore a un buffer di caratteri contenente un carattere '.' seguito dalla nuova estensione.

Valore restituito

Tipo: BOOL

Restituisce un valore diverso da zero se il nuovo percorso e l'estensione superano MAX_PATH caratteri.

Commenti

Nota

L'intestazione shlwapi.h definisce PathRenameExtension come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 4.71 o successiva)

Condividi tramite