Compartilhar via


Função GetSidIdentifierAuthority (securitybaseapi.h)

A função GetSidIdentifierAuthority retorna um ponteiro para a estrutura SID_IDENTIFIER_AUTHORITY em um SID ( identificador de segurança ) especificado.

Sintaxe

PSID_IDENTIFIER_AUTHORITY GetSidIdentifierAuthority(
  [in] PSID pSid
);

Parâmetros

[in] pSid

Um ponteiro para a estrutura SID para a qual um ponteiro para a estrutura SID_IDENTIFIER_AUTHORITY é retornado.

Essa função não manipula estruturas SID que não são válidas. Chame a função IsValidSid para verificar se a estrutura SID é válida antes de chamar essa função.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um ponteiro para a estrutura SID_IDENTIFIER_AUTHORITY para a estrutura sid especificada.

Se a função falhar, o valor retornado será indefinido. A função falhará se a estrutura SID apontada pelo parâmetro pSid não for válida. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Essa função usa um valor RID de 32 bits. Para aplicativos que exigem um valor RID maior, use CreateWellKnownSid e funções relacionadas.

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

CreateWellKnownSid

GetLengthSid

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

IsValidSid

SID

SID_IDENTIFIER_AUTHORITY