Funzione PathCchRemoveFileSpec (pathcch.h)

Articolo
03/01/2024

Rimuove l'ultimo elemento in una stringa di percorso, indipendentemente dal fatto che l'elemento sia un nome di file o un nome di directory. Viene rimossa anche la barra rovesciata iniziale dell'elemento.

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

NotaQuesta funzione deve essere usata al posto di PathRemoveFileSpec per evitare la possibilità di un sovraccarico del buffer.

Sintassi

WINPATHCCHAPI HRESULT PathCchRemoveFileSpec(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

Parametri

[in, out] pszPath

Puntatore alla stringa del percorso completo. Quando questa funzione viene restituita correttamente, la stringa avrà l'ultimo elemento e la barra rovesciata iniziale rimossa. Questa funzione non influisce sui percorsi radice, ad esempio "C:". Nel caso di un percorso radice, la stringa di percorso viene restituita invariata. Se una stringa di percorso termina con una barra rovesciata finale, viene rimossa solo la barra rovesciata.

[in] cchPath

Dimensioni del buffer a cui punta pszPath, in caratteri.

Valore restituito

Questa funzione restituisce S_OK se la funzione ha avuto esito positivo, S_FALSE se non c'è stato nulla da rimuovere o un codice di errore in caso contrario.

Commenti

Nella tabella seguente viene illustrato l'effetto di questa funzione su una selezione di stringhe di percorso.

Stringa originale	Stringa restituita
"C:\path1"	"C:\"
"C:\path1\path2"	"C:\path1"
"C:\path1\"	"C:\path1"
"\\path1\path2\path3"	"\\path1\path2"
"\path1"	"\"

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

Condividi tramite