Compartilhar via


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