Función GetSidSubAuthority (securitybaseapi.h)

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

Consulte también

Información general del control de acceso

Funciones básicas de Access Control

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthorityCount

IsValidSid

SID