Funzione SHRegGetPathA (shlwapi.h)

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.

Osservazioni

Il tipo di dati del valore del Registro di sistema specificato deve essere REG_EXPAND_SZ o REG_SZ. Se ha il tipo di 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.

Fabbisogno