Condividi tramite


Funzione PathRenameExtensionW (shlwapi.h)

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 uso improprio di questa funzione può causare un sovraccarico del buffer. È consigliabile usare la funzione PathCchRenameExtension più sicura .
 

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.

Osservazioni

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 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, Windows XP [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione shlwapi.h
libreria Shlwapi.lib
dll Shlwapi.dll (versione 4.71 o successiva)