Função AllocateAndInitializeSid (securitybaseapi.h)

Artigo
08/25/2023

A função AllocateAndInitializeSid aloca e inicializa um SID ( identificador de segurança ) com até oito subautoridades.

Sintaxe

BOOL AllocateAndInitializeSid(
  [in]  PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
  [in]  BYTE                      nSubAuthorityCount,
  [in]  DWORD                     nSubAuthority0,
  [in]  DWORD                     nSubAuthority1,
  [in]  DWORD                     nSubAuthority2,
  [in]  DWORD                     nSubAuthority3,
  [in]  DWORD                     nSubAuthority4,
  [in]  DWORD                     nSubAuthority5,
  [in]  DWORD                     nSubAuthority6,
  [in]  DWORD                     nSubAuthority7,
  [out] PSID                      *pSid
);

Parâmetros

[in] pIdentifierAuthority

Um ponteiro para uma estrutura SID_IDENTIFIER_AUTHORITY . Essa estrutura fornece o valor de autoridade do identificador de nível superior a ser definido no SID.

[in] nSubAuthorityCount

Especifica o número de subautoridades a serem colocadas no SID. Esse parâmetro também identifica quantos dos parâmetros de subautoridade têm valores significativos. Esse parâmetro deve conter um valor de 1 a 8.

Por exemplo, um valor de 3 indica que os valores de subautoridade especificados pelos parâmetros dwSubAuthority0, dwSubAuthority1 e dwSubAuthority2 têm valores significativos e para ignorar o restante.

[in] nSubAuthority0