Función AllocateAndInitializeSid (securitybaseapi.h)

La función AllocateAndInitializeSid asigna e inicializa un identificador de seguridad (SID) con hasta ocho subauthoridades.

Sintaxis

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

Puntero a una estructura SID_IDENTIFIER_AUTHORITY . Esta estructura proporciona el valor de autoridad de identificador de nivel superior que se va a establecer en el SID.

[in] nSubAuthorityCount

Especifica el número de subauthoridades que se van a colocar en el SID. Este parámetro también identifica cuántos de los parámetros de subautenticación tienen valores significativos. Este parámetro debe contener un valor de 1 a 8.

Por ejemplo, un valor de 3 indica que los valores de subauthority especificados por los parámetros dwSubAuthority0, dwSubAuthority1 y dwSubAuthority2 tienen valores significativos y para omitir el resto.

[in] nSubAuthority0

Valor de subauthoridad que se va a colocar en el SID.

[in] nSubAuthority1

Valor de subauthoridad que se va a colocar en el SID.

[in] nSubAuthority2

Valor de subauthoridad que se va a colocar en el SID.

[in] nSubAuthority3

Valor de subauthoridad que se va a colocar en el SID.

[in] nSubAuthority4

Valor de subauthoridad que se va a colocar en el SID.

[in] nSubAuthority5

Valor de subauthoridad que se va a colocar en el SID.

[in] nSubAuthority6

Valor de subauthoridad que se va a colocar en el SID.

[in] nSubAuthority7

Valor de subauthoridad que se va a colocar en el SID.

[out] pSid

Puntero a una variable que recibe el puntero a la estructura de SID asignada e inicializada.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Se debe liberar un SID asignado con la función AllocateAndInitializeSid mediante la función FreeSid .

Esta función crea un SID con un valor rid de 32 bits. Para las aplicaciones que requieren valores rid más largos, use CreateWellKnownSid.

Ejemplos

Para obtener un ejemplo que usa esta función, vea Creating a Security Descriptor for a New Object or Taking Object Ownership.

Requisitos

Consulte también

Control de acceso

Funciones básicas de Access Control

FreeSid

GetSidIdentifierAuthority

InitializeSid

SID_IDENTIFIER_AUTHORITY

SID conocidos