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 |