Funzione RegSetKeySecurity (winreg.h)

Articolo
03/04/2024

La funzione RegSetKeySecurity imposta la sicurezza di una chiave del Registro di sistema aperta.

Sintassi

LSTATUS RegSetKeySecurity(
  [in] HKEY                 hKey,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parametri

[in] hKey

Handle per una chiave aperta per cui è impostato il descrittore di sicurezza .

[in] SecurityInformation

Set di flag di bit che indicano il tipo di informazioni di sicurezza da impostare. Questo parametro può essere una combinazione dei flag SECURITY_INFORMATION bit.

[in] pSecurityDescriptor

Puntatore a una struttura SECURITY_DESCRIPTOR che specifica gli attributi di sicurezza da impostare per la chiave specificata.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce ERROR_SUCCESS.

Se la funzione ha esito negativo, restituisce 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

Se hKey è una delle chiavi predefinite, usare la funzione RegCloseKey per chiudere la chiave predefinita per assicurarsi che le nuove informazioni di sicurezza siano effettive al successivo riferimento alla chiave predefinita.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winreg.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll