Funzione RegSetKeyValueA (winreg.h)

  • Articolo

Imposta i dati per il valore specificato nella chiave e nella sottochiave del Registro di sistema specificati.

Sintassi

LSTATUS RegSetKeyValueA(
  [in]           HKEY    hKey,
  [in, optional] LPCSTR  lpSubKey,
  [in, optional] LPCSTR  lpValueName,
  [in]           DWORD   dwType,
  [in, optional] LPCVOID 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 delle chiavi del Registro di sistema e diritti di accesso.

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 della sottochiave relativa alla chiave identificata da hKey. Se la sottochiave non esiste, viene creata come chiave non volatile con un descrittore di sicurezza predefinito. Se questo parametro è NULL, il valore viene creato nella chiave specificata da hKey.

[in, optional] lpValueName

Nome del valore del Registro di sistema i cui dati devono essere aggiornati.

[in] dwType

Tipo di dati a cui punta il parametro lpData . Per un elenco dei tipi possibili, vedere Tipi di valore del Registro di sistema.

[in, optional] lpData

Dati da archiviare con il nome del valore specificato.

Per i tipi basati su stringhe, ad esempio REG_SZ, la stringa deve essere terminata con null. Con il tipo di dati REG_MULTI_SZ, la stringa deve essere terminata con due caratteri Null.

[in] cbData

Dimensioni delle informazioni a cui punta il parametro lpData , in byte. Se i dati sono di tipo REG_SZ, REG_EXPAND_SZ o REG_MULTI_SZ, cbData deve includere le dimensioni del carattere o dei caratteri null terminanti.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è 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

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versioni successive. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Nota

L'intestazione winreg.h definisce RegSetKeyValue come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winreg.h (include Windows.h)
Libreria Advapi32.lib
DLL Advapi32.dll

Vedi anche

RegDeleteKeyValue

Funzioni del Registro di sistema