Compartilhar via


Função GetSidLengthRequired (securitybaseapi.h)

A função GetSidLengthRequired retorna o comprimento, em bytes, do buffer necessário para armazenar um SID com um número especificado de subautoridades.

Sintaxe

DWORD GetSidLengthRequired(
  [in] UCHAR nSubAuthorityCount
);

Parâmetros

[in] nSubAuthorityCount

Especifica o número de subautoridades a serem armazenadas na estrutura sid.

Valor retornado

O valor retornado é o comprimento, em bytes, do buffer necessário para armazenar a estrutura sid. Essa função não pode falhar.

Comentários

A estrutura SID especificada em nSubAuthorityCount usa um valor RID de 32 bits. Para aplicativos que exigem valores RID mais longos, use CreateWellKnownSid e funções relacionadas.

Requisitos

   
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

AllocateAndInitializeSid

Funções de Controle de Acesso básicas

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidSubAuthority

GetSidSubAuthorityCount

InitializeSid

IsValidSid

SID