Compartilhar via


Função AllocateAndInitializeSid (securitybaseapi.h)

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

Valor de subautoridade a ser colocado no SID.

[in] nSubAuthority1

Valor de subautoridade a ser colocado no SID.

[in] nSubAuthority2

Valor de subautoridade a ser colocado no SID.

[in] nSubAuthority3

Valor de subautoridade a ser colocado no SID.

[in] nSubAuthority4

Valor de subautoridade a ser colocado no SID.

[in] nSubAuthority5

Valor de subautoridade a ser colocado no SID.

[in] nSubAuthority6

Valor de subautoridade a ser colocado no SID.

[in] nSubAuthority7

Valor de subautoridade a ser colocado no SID.

[out] pSid

Um ponteiro para uma variável que recebe o ponteiro para a estrutura sid alocada e inicializada.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Um SID alocado com a função AllocateAndInitializeSid deve ser liberado usando a função FreeSid .

Essa função cria um SID com um valor RID de 32 bits. Para aplicativos que exigem valores RID mais longos, use CreateWellKnownSid.

Exemplos

Para obter um exemplo que usa essa função, consulte Criando um descritor de segurança para um novo objeto ou Tomando a propriedade do objeto.

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

Controle de acesso

Funções de Controle de Acesso básicas

FreeSid

GetSidIdentifierAuthority

InitializeSid

SID_IDENTIFIER_AUTHORITY

SIDs conhecidos