Funzione PathStripToRootA (shlwapi.h)

Articolo
03/13/2024

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

Nota L'uso improprio di questa funzione può causare un overrun del buffer. È consigliabile usare la funzione PathCchStripToRoot più sicura al suo posto.

Sintassi

BOOL PathStripToRootA(
  [in, out] LPSTR pszPath
);

Parametri

[in, out] pszPath

Tipo: LPTSTR

Puntatore a una stringa con terminazione null di lunghezza MAX_PATH contenente il percorso da convertire. Quando questa funzione restituisce correttamente, questa stringa contiene solo le informazioni radice acquisite da tale percorso.

Valore restituito

Tipo: BOOL

Restituisce TRUE se è stata trovata una lettera di unità valida nel percorso o FALSE in caso contrario.

Commenti

Nota

L'intestazione shlwapi.h definisce PathStripToRoot come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 4.71 o successiva)

Condividi tramite