Funzione PathUnExpandEnvStringsA (shlwapi.h)

Articolo
11/20/2024

Sostituisce determinati nomi di cartella in un percorso completo con la stringa di ambiente associata.

Sintassi

BOOL PathUnExpandEnvStringsA(
  [in]  LPCSTR pszPath,
  [out] LPSTR  pszBuf,
  [in]  UINT   cchBuf
);

Parametri

[in] pszPath

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null di lunghezza massima MAX_PATH che contiene il percorso da annullare.

[out] pszBuf

Tipo: LPTSTR

Puntatore a un buffer che, quando questo metodo viene restituito correttamente, riceve la stringa non espansa. Le dimensioni di questo buffer devono essere impostate su MAX_PATH per assicurarsi che sia sufficientemente grande da contenere la stringa restituita.

[in] cchBuf

Tipo: UINT

Dimensione, in caratteri, nel buffer di pszBuf.

Valore restituito

Tipo: bool

Restituisce TRUE in caso di esito positivo; in caso contrario, FALSE.

Osservazioni

I percorsi di cartella seguenti vengono sostituiti dalla stringa di ambiente equivalente.

Cartella	Stringa di ambiente
Cartella Del profilo Tutti gli utenti	%ALLUSERSPROFILE%
Cartella dei dati dell'applicazione dell'utente corrente (solo Windows Vista e versioni successive).	%APPDATA%
Nome del sistema	%COMPUTERNAME%
Cartella Programmi	%ProgramFiles%
Cartella radice del sistema	%SystemRoot%
Lettera di unità di sistema	%SystemDrive%
Cartella del profilo dell'utente corrente	%USERPROFILE%

Nota %APPDATA% e %USERPROFILE% sono relativi all'utente che effettua la chiamata. Questa funzione non funziona se l'utente viene rappresentato da un servizio. Per altre informazioni sui problemi di controllo di accesso, vedere Controllo di accesso.

Le variabili di ambiente elencate nella tabella precedente potrebbero non essere tutte impostate in tutti i sistemi. Se una variabile di ambiente non è impostata, non è espansa.

Nota

L'intestazione shlwapi.h definisce PathUnExpandEnvStrings 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 5.0 o successiva)

Vedere anche

DoEnvironmentSubst

Condividi tramite