Función SetKernelObjectSecurity (securitybaseapi.h)

Artículo
03/05/2024

La función SetKernelObjectSecurity establece la seguridad de un objeto kernel. Por ejemplo, esto puede ser un proceso, un subproceso o un evento.

Nota Esta función no se debe usar al establecer un descriptor de seguridad en objetos del sistema de archivos. En su lugar, use las funciones SetSecurityInfo o SetNamedSecurityInfo .

Sintaxis

BOOL SetKernelObjectSecurity(
  [in] HANDLE               Handle,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR SecurityDescriptor
);

Parámetros

[in] Handle

Identificador de un objeto kernel para el que se establece la información 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] SecurityDescriptor

Puntero a una estructura SECURITY_DESCRIPTOR que contiene la nueva información de seguridad.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero.

Si se produce un error en la función, devuelve cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos

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