Funzione PathBuildRootA (shlwapi.h)

Articolo
11/20/2024

Crea un percorso radice da un determinato numero di unità.

Sintassi

LPSTR PathBuildRootA(
  [out] LPSTR pszRoot,
  [in]  int   iDrive
);

Parametri

[out] pszRoot

Tipo: LPTSTR

Puntatore alla stringa che riceve il percorso radice costruito. Questo buffer deve avere dimensioni di almeno quattro caratteri.

[in] iDrive

Tipo: int

Variabile di tipo int che indica il numero di unità desiderato. Deve essere compreso tra 0 e 25.

Valore restituito

Tipo: LPTSTR

Restituisce l'indirizzo del percorso radice costruito. Se la chiamata ha esito negativo per qualsiasi motivo (ad esempio, un numero di unità non valido), szRoot viene restituito invariato.

Osservazioni

Nota

L'intestazione shlwapi.h definisce PathBuildRoot come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 4.71 o successiva)

Condividi tramite