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
| 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