Funzione RegCloseKey (winreg.h)

Articolo
08/27/2023

Chiude un handle alla chiave del Registro di sistema specificata.

Sintassi

LSTATUS RegCloseKey(
  [in] HKEY hKey
);

Parametri

[in] hKey

Handle per la chiave aperta da chiudere. L'handle deve essere stato aperto dalla funzione RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx, RegOpenKeyTransacted o RegConnectRegistry .

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

L'handle per una chiave specificata non deve essere utilizzato dopo la chiusura, perché non sarà più valido. Gli handle di chiave non devono essere lasciati aperti più del necessario.

La funzione RegCloseKey non scrive necessariamente informazioni nel Registro di sistema prima di restituire; il caricamento della cache sul disco rigido può richiedere fino a diversi secondi. Se un'applicazione deve scrivere in modo esplicito le informazioni del Registro di sistema sul disco rigido, può usare la funzione RegFlushKey . RegFlushKey, tuttavia, usa molte risorse di sistema e deve essere chiamato solo quando necessario.

Esempio

Per un esempio, vedere Eliminazione di una chiave con sottochiavi.

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