Funzione PathCchRenameExtension (pathcch.h)

Sostituisce l'estensione di un nome file alla fine di una stringa di percorso con una nuova estensione. Se la stringa di percorso non termina con un'estensione, viene aggiunta la nuova estensione.

Questa funzione è diversa da PathRenameExtension in quanto accetta percorsi con prefissi "\", "\?" e "\?\UNC".

Sintassi

WINPATHCCHAPI HRESULT PathCchRenameExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath,
  [in]      PCWSTR pszExt
);

Parametri

[in, out] pszPath

Puntatore alla stringa di percorso. Quando questa funzione viene restituita correttamente, questo valore punta alla stessa stringa, ma con l'estensione rinominata o aggiunta.

[in] cchPath

Dimensioni del buffer a cui punta pszPath, in caratteri.

[in] pszExt

Puntatore alla nuova stringa di estensione. Il carattere iniziale '.' è facoltativo. Nel caso di una stringa vuota (""), viene rimossa qualsiasi estensione esistente nella stringa di percorso.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti