Condividi tramite

Funzione PathCchRenameExtension (pathcch.h)

  • Articolo

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".

Nota Questa funzione deve essere usata al posto di PathRenameExtension per evitare la possibilità di un sovraccarico del buffer.

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

Requisito Valore
Client minimo supportato Windows 8 [app desktop | App UWP]
Server minimo supportato Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione pathcch.h
Libreria Pathcch.lib