Funzione SHRegGetPathA (shlwapi.h)

Articolo
03/02/2024

Recupera un percorso di file dal Registro di sistema, espandendo le variabili di ambiente in base alle esigenze.

Sintassi

LSTATUS SHRegGetPathA(
  [in]  HKEY   hKey,
  [in]  LPCSTR pcszSubKey,
  [in]  LPCSTR pcszValue,
  [out] LPSTR  pszPath,
        DWORD  dwFlags
);

Parametri

[in] hKey

Tipo: HKEY

Handle per una chiave attualmente aperta o una chiave radice del Registro di sistema.

[in] pcszSubKey

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null contenente il nome della sottochiave.

[in] pcszValue

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null contenente il nome del valore che contiene la stringa di percorso non espansa.

[out] pszPath

Tipo: LPTSTR

Buffer per contenere il percorso espanso. È necessario impostare le dimensioni di questo buffer su MAX_PATH per assicurarsi che sia sufficientemente grande da contenere la stringa restituita.

dwFlags

Tipo: DWORD

Riservato.

Valore restituito

Tipo: LSTATUS

Restituisce ERROR_SUCCESS in caso di esito positivo o un codice di errore di Windows in caso contrario.

Commenti

Il tipo di dati del valore del Registro di sistema specificato deve essere REG_EXPAND_SZ o REG_SZ. Se ha il tipo REG_EXPAND_SZ , tutte le variabili di ambiente nella stringa del Registro di sistema verranno espanse con ExpandEnvironmentStrings. Se ha il tipo di dati REG_SZ , le variabili di ambiente non verranno espanse e la stringa a cui punta pszPath sarà identica alla stringa nel Registro di sistema.

Le stringhe di ambiente seguenti verranno sostituite dal percorso equivalente.

Stringa di ambiente	Cartella
%USERPROFILE%	Cartella del profilo dell'utente corrente
%ALLUSERSPROFILE%	Cartella Del profilo Tutti gli utenti
%ProgramFiles%	Cartella Programmi
%SystemRoot%	Cartella radice del sistema
%SystemDrive%	Lettera di unità di sistema

Nota %USERPROFILE% è relativo all'utente che effettua la chiamata. Questa funzione non funziona se l'utente viene rappresentato da un servizio.

Nota

L'intestazione shlwapi.h definisce SHRegGetPath 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

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 5.0 o successiva)

Condividi tramite