Função SetKernelObjectSecurity (securitybaseapi.h)

Artigo
03/01/2024

A função SetKernelObjectSecurity define a segurança de um objeto kernel. Por exemplo, isso pode ser um processo, thread ou evento.

Nota Essa função não deve ser usada ao definir um descritor de segurança em objetos do sistema de arquivos. Em vez disso, use as funções SetSecurityInfo ou SetNamedSecurityInfo .

Sintaxe

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

Parâmetros

[in] Handle

Um identificador para um objeto kernel para o qual as informações de segurança são definidas.

[in] SecurityInformation

Um conjunto de sinalizadores de bits que indicam o tipo de informações de segurança a serem definidas. Esse parâmetro pode ser uma combinação dos sinalizadores de bits SECURITY_INFORMATION .

[in] SecurityDescriptor

Um ponteiro para uma estrutura SECURITY_DESCRIPTOR que contém as novas informações de segurança.

Retornar valor

Se a função for bem-sucedida, a função retornará diferente de zero.

Se a função falhar, ela retornará zero. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	securitybaseapi.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll