Condividi tramite

Funzione PathCchAddExtension (pathcch.h)

  • Articolo

Aggiunge un'estensione di nome file a una stringa di percorso.

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

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

Sintassi

WINPATHCCHAPI HRESULT PathCchAddExtension(
  [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, il buffer contiene la stringa con l'estensione aggiunta. Questo valore non deve essere NULL.

Nota Se la stringa originale ha già un'estensione di file presente, non verrà aggiunta alcuna nuova estensione e la stringa originale non verrà modificata.

[in] cchPath

Dimensioni del buffer a cui punta pszPath, in caratteri.

[in] pszExt

Puntatore alla stringa di estensione del nome file. Questa stringa può essere specificata con o senza un punto precedente (".ext" o "ext").

Valore restituito

Questa funzione restituisce un codice HRESULT , incluso quanto segue.

Codice restituito Descrizione
S_OK
 Funzione completata. Si noti che questo include anche il caso di un'estensione vuota, ad esempio un punto senza caratteri che lo seguono. In tal caso, la stringa originale viene restituita invariata.
E_INVALIDARG
 Questo valore può essere causato da diversi elementi, ad esempio il parametro pszPath impostato su NULL, cchPath impostato su 0 o un valore maggiore di PATHCCH_MAX_CCH oppure la stringa di estensione contenente caratteri non validi o altrimenti non è un'estensione valida.
S_FALSE
 La stringa originale ha già un'estensione.
PATHCCH_E_FILENAME_TOO_LONG
 Il buffer è troppo piccolo per contenere la stringa restituita.

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