unsigned* standard get_identity_subauthority(identity* pointer,
                                             unsigned subauthority)

This function obtains a pointer to a subauthority within a security identity.


identity* pointer

A pointer to the security identity whose subauthority is being queried.

unsigned subauthority

The 0-based index of the subauthority whose address is to be returned.



A pointer to the subauthority with the specified index. If an invalid security identity is specified or if the subauthority count exceeds the number of subauthorities contained within the security identity, the value returned is undefined.


The function get_identity_subauthority_count may be issued to ascertain the number of subauthorities contained within a security identity.