GetSidSubAuthorityCount

The GetSidSubAuthorityCount function returns a pointer to the member in a SID structure containing the subauthority count. (A SID is a security identifier.)

PUCHAR GetSidSubAuthorityCount(
  PSID pSid   // security identifier
);

Parameters

pSid

[in] Pointer to the SID structure from which a pointer to the subauthority count is returned.

Return Values

If the function succeeds, the return value is a pointer to the subauthority count for the specified SID structure.

If the function fails, the return value is undefined. The function fails if the specified SID structure is invalid. To get extended error information, call GetLastError.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Advapi32.lib.

See Also

Access Control Overview, Access Control Functions, GetLengthSid, GetSidIdentifierAuthority, GetSidLengthRequired, GetSidSubAuthority, IsValidSid, SID