Compartilhar via


Função GetSidSubAuthorityCount (securitybaseapi.h)

A função GetSidSubAuthorityCount retorna um ponteiro para o membro em uma estrutura sid ( identificador de segurança ) que contém a contagem de subautoridade.

Sintaxe

PUCHAR GetSidSubAuthorityCount(
  [in] PSID pSid
);

Parâmetros

[in] pSid

Um ponteiro para a estrutura SID da qual um ponteiro para a contagem de subautoridade é 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 contagem de subautoridade para a estrutura sid especificada.

Se a função falhar, o valor retornado será indefinido. A função falhará se a estrutura sid especificada não for válida. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A estrutura SID especificada no pSid usa um valor 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 básicas de Controle de Acesso

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

IsValidSid

SID