Funzione RegSetValueA (winreg.h)

Articolo
08/27/2023

Imposta i dati per il valore predefinito o senza nome di una chiave del Registro di sistema specificata. I dati devono essere una stringa di testo.

Nota Questa funzione viene fornita solo per la compatibilità con le versioni a 16 bit di Windows. Le applicazioni devono usare la funzione RegSetValueEx .

Sintassi

LSTATUS RegSetValueA(
  [in]           HKEY   hKey,
  [in, optional] LPCSTR lpSubKey,
  [in]           DWORD  dwType,
  [in]           LPCSTR lpData,
  [in]           DWORD  cbData
);

Parametri

[in] hKey

Handle per una chiave del Registro di sistema aperta. La chiave deve essere stata aperta con il diritto di accesso KEY_SET_VALUE. Per altre informazioni, vedere Sicurezza e diritti di accesso delle chiavi del Registro di sistema.

Questo handle viene restituito dalla funzione RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx o RegOpenKeyTransacted . Può anche essere una delle chiavi predefinite seguenti:

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] lpSubKey

Nome di una sottochiave del parametro hKey . La funzione imposta il valore predefinito della sottochiave specificata. Se lpSubKey non esiste, la funzione la crea.

I nomi delle chiavi non fanno distinzione tra maiuscole e minuscole.

Se questo parametro è NULL o punta a una stringa vuota, la funzione imposta il valore predefinito della chiave identificata da hKey.

Per altre informazioni, vedere Limiti delle dimensioni degli elementi del Registro di sistema.

[in] dwType

Tipo di informazioni da archiviare. Questo parametro deve essere il tipo di REG_SZ. Per archiviare altri tipi di dati, usare la funzione RegSetValueEx .

[in] lpData

Dati da archiviare. Questo parametro non può essere NULL.

[in] cbData

Questo parametro viene ignorato. La funzione calcola questo valore in base alle dimensioni dei dati nel parametro lpData .

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero definito in Winerror.h. È possibile usare la funzione FormatMessage con il flag FORMAT_MESSAGE_FROM_SYSTEM per ottenere una descrizione generica dell'errore.

Commenti

Se la chiave specificata dal parametro lpSubKey non esiste, la funzione RegSetValue la crea.

Se viene usata la versione ANSI di questa funzione (chiamando in modo esplicito RegSetValueA o non definendo UNICODE prima di includere il file Windows.h), il parametro lpData deve essere una stringa di caratteri ANSI. La stringa viene convertita in Unicode prima che venga archiviata nel Registro di sistema.

Nota

L'intestazione winreg.h definisce RegSetValue 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 [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winreg.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll