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