Funzione PathBuildRootW (shlwapi.h)

Articolo
08/26/2023

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

Sintassi

LPWSTR PathBuildRootW(
  [out] LPWSTR 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 non riesce per qualsiasi motivo (ad esempio, un numero di unità non valido), szRoot viene restituito invariato.

Commenti

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


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