Compartilhar via


Função GetSidSubAuthority (securitybaseapi.h)

A função GetSidSubAuthority retorna um ponteiro para uma subautoridade especificada em um SID ( identificador de segurança ). O valor de subautoridade é um RID ( identificador relativo ).

Sintaxe

PDWORD GetSidSubAuthority(
  [in] PSID  pSid,
  [in] DWORD nSubAuthority
);

Parâmetros

[in] pSid

Um ponteiro para a estrutura sid da qual um ponteiro para uma subautoridade deve ser 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.

[in] nSubAuthority

Especifica um valor de índice que identifica o elemento de matriz de subautoridade cujo endereço a função retornará. A função não executa nenhum teste de validação nesse valor. Um aplicativo pode chamar a função GetSidSubAuthorityCount para descobrir o intervalo de valores aceitáveis.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um ponteiro para a subautoridade sid especificada. Para obter informações de erro estendidas, chame GetLastError.

Se a função falhar, o valor retornado será indefinido. A função falhará se a estrutura sid especificada não for válida ou se o valor de índice especificado pelo parâmetro nSubAuthority estiver fora dos limites.

Comentários

A estrutura sid especificada no pSid usa um valor RID de 32 bits. Para aplicativos que exigem valores RID mais longos, 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 de Controle de Acesso básicas

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthorityCount

IsValidSid

SID