Función GetSidSubAuthorityCount (securitybaseapi.h)

La función GetSidSubAuthorityCount devuelve un puntero al miembro de una estructura de identificador de seguridad (SID) que contiene el recuento de subauthoridad.

Sintaxis

PUCHAR GetSidSubAuthorityCount(
  [in] PSID pSid
);

Parámetros

[in] pSid

Puntero a la estructura de SID desde la que se devuelve un puntero al recuento de subauthoridad.

Esta función no controla las estructuras de SID que no son válidas. Llame a la función IsValidSid para comprobar que la estructura del SID es válida antes de llamar a esta función.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un puntero al número de subauthoridad de la estructura de SID especificada.

Si se produce un error en la función, el valor devuelto no está definido. Se produce un error en la función si la estructura de SID especificada no es válida. Para obtener información de error extendida, llame a GetLastError.

Comentarios

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

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

Consulte también

Información general del control de acceso

Funciones básicas de Access Control

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

IsValidSid

SID