Função GetSidSubAuthority (securitybaseapi.h)

Artigo
03/01/2024

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