Função GetSecurityDescriptorControl (securitybaseapi.h)

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

Confira também

Visão geral do Controle de Acesso

Funções básicas de Controle de Acesso

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL