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 |