Funzione PathCchRemoveFileSpec (pathcch.h)

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

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.

Requisiti