Função GetSecurityDescriptorControl (securitybaseapi.h)

Artigo
03/01/2024

A função GetSecurityDescriptorControl recupera um controle de descritor de segurança e informações de revisão.

Sintaxe

BOOL GetSecurityDescriptorControl(
  [in]  PSECURITY_DESCRIPTOR         pSecurityDescriptor,
  [out] PSECURITY_DESCRIPTOR_CONTROL pControl,
  [out] LPDWORD                      lpdwRevision
);

Parâmetros

[in] pSecurityDescriptor

Um ponteiro para uma estrutura SECURITY_DESCRIPTOR cujas informações de controle e revisão a função recupera.

[out] pControl

Um ponteiro para uma estrutura SECURITY_DESCRIPTOR_CONTROL que recebe as informações de controle do descritor de segurança.

[out] lpdwRevision

Um ponteiro para uma variável que recebe o valor de revisão do descritor de segurança. Esse valor é sempre definido, mesmo quando GetSecurityDescriptorControl retorna um erro.

Valor retornado

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

Se a função falhar, o valor retornado será 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