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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | securitybaseapi.h (incluya Windows.h) |
| Library | Advapi32.lib |
| Archivo DLL | Advapi32.dll |