Funzione RegDeleteValueW (winreg.h)

Articolo
11/20/2024

Rimuove un valore denominato dalla chiave del Registro di sistema specificata. Si noti che i nomi dei valori non fanno distinzione tra maiuscole e minuscole.

Sintassi

LSTATUS RegDeleteValueW(
  [in]           HKEY    hKey,
  [in, optional] LPCWSTR 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 dal RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyExo funzione 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 RegSetValue 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.

Osservazioni

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 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 [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winreg.h (include Windows.h)
libreria	Advapi32.lib
dll	Advapi32.dll

Vedere anche

RegSetValueEx

funzioni del Registro di sistema

Panoramica del Registro di sistema

Condividi tramite