Funzione PathCchStripToRoot (pathcch.h)

Articolo
03/05/2024

Rimuove tutti gli elementi di file e directory in un percorso tranne le informazioni radice.

Questa funzione differisce dai prefissi PathStripToRoot in cui accetta i percorsi con "\", "\?" e "\?\UNC".

Nota Questa funzione deve essere usata al posto di PathStripToRoot per impedire la possibilità di un overrun del buffer.

Sintassi

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

Parametri

[in, out] pszPath

Puntatore alla stringa del percorso. Quando questa funzione restituisce correttamente, questa stringa contiene solo le informazioni radice acquisite da tale percorso.

[in] cchPath

Dimensioni del buffer a cui punta pszPath, in caratteri.

Valore restituito

Questa funzione restituisce S_OK se il percorso è stato troncato, S_FALSE se il percorso era già solo una radice o un codice di errore HRESULT .

Commenti

Alcuni esempi dell'effetto di questa funzione:

Stringa iniziale	Stringa finale
"C:\path1\path2\file"	"C:\"
"\\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