Condividi tramite


Funzione RegCloseKey (winreg.h)

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

Vedi anche

RegConnectRegistry

RegCreateKeyEx

RegDeleteKey

RegFlushKey

Regopenkeyex

Funzioni del Registro di sistema

Panoramica del Registro di sistema