EqualSid

The EqualSid function tests two security identifier (SID) values for equality. Two SIDs must match exactly to be considered equal.

BOOL EqualSid(
  PSID pSid1,  // first SID
  PSID pSid2   // second SID
);

Parameters

pSid1

[in] Pointer to the first SID structure to compare. This structure is assumed to be valid.

pSid2

[in] Pointer to the second SID structure to compare. It also is assumed to be valid.

Return Values

If the SID structures are equal, the return value is nonzero.

If the SID structures are not equal, the return value is zero. To get extended error information, call GetLastError.

If either SID structure is invalid, the return value is undefined.

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, EqualPrefixSid, IsValidSid, SID