Funzione RegDeleteValueA (winreg.h)
Rimuove un valore denominato dalla chiave del Registro di sistema specificata. Si noti che i nomi dei valori non sono distinzione tra maiuscole e minuscole.
Sintassi
LSTATUS RegDeleteValueA(
[in] HKEY hKey,
[in, optional] LPCSTR lpValueName
);
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] lpValueName
Valore del Registro di sistema da rimuovere. Se questo parametro è NULL o una stringa vuota, il valore impostato dalla funzione RegSetValueEx viene rimosso.
Per altre informazioni, vedere Limiti delle dimensioni degli elementi del Registro di sistema.
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
Nota
L'intestazione winreg.h definisce RegDeleteValue 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
| 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 |