get_identity_subauthority


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

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

Parameters

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.

Return

unsigned*

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.

Notes

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