RtlSubAuthoritySid function (ntifs.h)
The RtlSubAuthoritySid routine returns a pointer to a specified subauthority of a security identifier (SID).
Syntax
NTSYSAPI PULONG RtlSubAuthoritySid(
[in] PSID Sid,
ULONG SubAuthority
);
Parameters
[in] Sid
Pointer to the SID structure. The SID must have been initialized by calling RtlInitializeSid.
SubAuthority
Zero-based index indicating which subauthority is being specified. This value is not validated against the number of subauthorities in the SID.
Return value
If the call to RtlSubAuthoritySid succeeds, the return value is a pointer to the specified SID subauthority. The subauthority value is a relative identifier. (The relative identifier, or RID, is the portion of a SID that identifies a user or group in relation to the authority that issued the SID.)
Remarks
For more information about security and access control, see Windows security model for driver developers and the documentation on these topics in the Windows SDK.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 |
| Target Platform | Universal |
| Header | ntifs.h (include Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe (kernel mode); Ntdll.dll (user mode) |
| IRQL | < DISPATCH_LEVEL |