Función GetSidSubAuthority (securitybaseapi.h)

Artículo
03/13/2024

La función GetSidSubAuthority devuelve un puntero a una subauthoridad especificada en un identificador de seguridad (SID). El valor de la subauthoridad es un identificador relativo (RID).

Sintaxis

PDWORD GetSidSubAuthority(
  [in] PSID  pSid,
  [in] DWORD nSubAuthority
);

Parámetros

[in] pSid

Puntero a la estructura del SID desde la que se va a devolver un puntero a una subautoridad.

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.

[in] nSubAuthority

Especifica un valor de índice que identifica el elemento de matriz de subauthority cuya dirección devolverá la función. La función no realiza pruebas de validación en este valor. Una aplicación puede llamar a la función GetSidSubAuthorityCount para detectar el intervalo de valores aceptables.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un puntero a la subauthoridad del SID especificado. Para obtener información de error extendida, llame a GetLastError.

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 del SID especificada no es válida o si el valor de índice especificado por el parámetro nSubAuthority está fuera de los límites.

Comentarios

La estructura de SID especificada en pSid usa un valor RID de 32 bits. Para 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