Função GetSecurityDescriptorOwner (securitybaseapi.h)

Artigo
03/05/2024

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