Función RegSetKeySecurity (winreg.h)

Artículo
08/27/2023

La función RegSetKeySecurity establece la seguridad de una clave del Registro abierta.

Sintaxis

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

Parámetros

[in] hKey

Identificador de una clave abierta para la que se establece el descriptor de seguridad .

[in] SecurityInformation

Conjunto de marcas de bits que indican el tipo de información de seguridad que se va a establecer. Este parámetro puede ser una combinación de las marcas de bits de SECURITY_INFORMATION .

[in] pSecurityDescriptor

Puntero a una estructura de SECURITY_DESCRIPTOR que especifica los atributos de seguridad que se van a establecer para la clave especificada.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve ERROR_SUCCESS.

Si se produce un error en la función, devuelve un código de error distinto de cero definido en WinError.h. Puede usar la función FormatMessage con la marca FORMAT_MESSAGE_FROM_SYSTEM para obtener una descripción genérica del error.

Comentarios

Si hKey es una de las claves predefinidas, use la función RegCloseKey para cerrar la clave predefinida para asegurarse de que la nueva información de seguridad está en vigor la próxima vez que se haga referencia a la clave predefinida.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winreg.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll