RtlSubAuthoritySid function

The RtlSubAuthoritySid routine returns a pointer to a specified subauthority of a security identifier (SID).

Syntax

NTSYSAPI PULONG RtlSubAuthoritySid(
  PSID  Sid,
  ULONG SubAuthority
);

Parameters

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 the documentation on these topics in the Microsoft Windows SDK.

Requirements

   
Minimum supported client This routine is available on Microsoft Windows 2000 and later.
Target Platform Universal
Header ntifs.h (include Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe (kernel mode); Ntdll.dll (user mode)
IRQL "< DISPATCH_LEVEL"

See Also

RtlInitializeSid

SID