Compartilhar via


Função GetSecurityDescriptorOwner (securitybaseapi.h)

A função GetSecurityDescriptorOwner recupera as informações do proprietário de um descritor de segurança.

Sintaxe

BOOL GetSecurityDescriptorOwner(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] PSID                 *pOwner,
  [out] LPBOOL               lpbOwnerDefaulted
);

Parâmetros

[in] pSecurityDescriptor

Um ponteiro para uma estrutura SECURITY_DESCRIPTOR cujas informações de proprietário a função recupera.

[out] pOwner

Um ponteiro para um ponteiro para um SID ( identificador de segurança ) que identifica o proprietário quando a função retorna. Se o descritor de segurança não contiver um proprietário, a função definirá o ponteiro apontado por pOwner como NULL e ignorará o parâmetro de saída restante, lpbOwnerDefaulted. Se o descritor de segurança contiver um proprietário, a função definirá o ponteiro apontado por pOwner para o endereço do SID proprietário do descritor de segurança e fornecerá um valor válido para a variável apontada por lpbOwnerDefaulted.

[out] lpbOwnerDefaulted

Um ponteiro para um sinalizador definido como o valor do sinalizador SE_OWNER_DEFAULTED na estrutura SECURITY_DESCRIPTOR_CONTROL quando a função retorna. Se o valor armazenado na variável apontada pelo parâmetro pOwner for NULL, nenhum valor será definido.

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

Confira também

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

Controle de Acesso de baixo nível

Funções de Controle de Acesso de baixo nível

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorOwner