Función GetSidLengthRequired (securitybaseapi.h)

La función GetSidLengthRequired devuelve la longitud, en bytes, del búfer necesario para almacenar un SID con un número especificado de subauthoridades.

Sintaxis

DWORD GetSidLengthRequired(
  [in] UCHAR nSubAuthorityCount
);

Parámetros

[in] nSubAuthorityCount

Especifica el número de subauthoridades que se almacenarán en la estructura del SID .

Valor devuelto

El valor devuelto es la longitud, en bytes, del búfer necesario para almacenar la estructura del SID . Esta función no puede producir un error.

Comentarios

La estructura de SID especificada en nSubAuthorityCount usa un valor RID de 32 bits. En el caso de las aplicaciones que requieren valores rid más largos, use CreateWellKnownSid y funciones relacionadas.

Requisitos

   
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

Consulte también

Información general del control de acceso

AllocateAndInitializeSid

Funciones básicas de Access Control

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidSubAuthority

GetSidSubAuthorityCount

InitializeSid

IsValidSid

SID