Função GetSidSubAuthorityCount (securitybaseapi.h)

Artigo
03/05/2024

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