Share via

CSid::GetSubAuthority

  • Article

Returns a specified subauthority in a SID (security identifier) structure.

DWORD GetSubAuthority( 
   DWORD nSubAuthority  
) const throw( );

Parameters

  • nSubAuthority
    The subauthority.

Return Value

Returns the subauthority referenced by nSubAuthority. The subauthority value is a relative identifier (RID).

Remarks

The nSubAuthority parameter specifies an index value identifying the subauthority array element the method will return. The method performs no validation tests on this value. An application can call CSid::GetSubAuthorityCount to discover the range of acceptable values.

Note

Under debug builds the function will cause an ASSERT if the CSid object is not valid.

Requirements

Header: atlsecurity.h

See Also

Reference

CSid Class

CSid::GetPSID_IDENTIFIER_AUTHORITY