Condividi tramite

Funzione SHRegSetPathA (shlwapi.h)

  • Articolo

Accetta un percorso di file, sostituisce i nomi delle cartelle con le stringhe di ambiente e inserisce la stringa risultante nel Registro di sistema.

Sintassi

LSTATUS SHRegSetPathA(
  [in] HKEY   hKey,
  [in] LPCSTR pcszSubKey,
  [in] LPCSTR pcszValue,
  [in] LPCSTR pcszPath,
       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 di una sottochiave esistente. Se la sottochiave non esiste, SHRegSetPath avrà esito negativo.

[in] pcszValue

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null con il nome del valore in cui contenere la stringa di percorso.

[in] pcszPath

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null con un percorso di file completo.

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

Per Windows 2000, SHRegSetPath usa PathUnExpandEnvStrings per convertire i nomi delle cartelle nella stringa di ambiente corrispondente. Se sono state sostituite variabili di ambiente, il valore del Registro di sistema verrà impostato con il tipo di dati REG_EXPAND_SZ. In caso contrario, verrà impostato con il tipo di dati REG_SZ.

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

Cartella Stringa di ambiente
Cartella del profilo dell'utente corrente %USERPROFILE%
Cartella Del profilo Tutti gli utenti %ALLUSERSPROFILE%
Cartella Programmi %ProgramFiles%
Cartella radice del sistema %SystemRoot%
Lettera di unità di sistema %SystemDrive%
 
Nota %USERPROFILE% è relativo all'utente che effettua la chiamata. Questa funzione non funziona se l'utente viene rappresentato da un servizio.
 
Le variabili di ambiente elencate nella tabella precedente potrebbero non essere tutte impostate in un particolare sistema. Se una variabile di ambiente non è impostata, non verrà espansa. In particolare, nessuna di queste variabili viene impostata per l'ambiente predefinito di Windows 95 o Windows 98. La variabile %ProgramFiles% è una novità per Windows 2000 e in genere non verrà impostata nei sistemi Microsoft Windows NT 4.0.

Nota

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