CompareSecurityIds function

Compares two security identifiers (SIDs) for equivalence.

Syntax


HRESULT CompareSecurityIds(
             BYTE  *pbSecurityId1,
             DWORD dwLen1,
             BYTE  *pbSecurityId2,
             DWORD dwLen2,
  _Reserved_ DWORD dwReserved
);

Parameters

pbSecurityId1: A pointer to a byte value that identifies the first SID.
dwLen1: An unsigned long integer value that contains the first SID array length.
pbSecurityId2: A pointer to a byte value that identifies the second SID.
dwLen2: An unsigned long integer value that contains the second SID array length.
dwReserved: Reserved. Must be set to 0.

Return value

Returns one of the following values.

Return code	Description
S_OK	The SIDs match.
S_FALSE	The SIDs do not match.
E_INVALIDARG	Not a valid SID.

Remarks

Only the domain names of both SIDs are considered for a match. You can compare Domain Name System (DNS) or Internationalized Domain Name (IDN) URLs, but not SIDs generated from an IP address or intranet sites.

If one SID is derived from a Mark of the Web, both must be.

Requirements

Minimum supported client	Windows XP with SP2
Minimum supported server	Windows Server 2003
Product	Internet Explorer 6.0
Header	Urlmon.h
Library	Urlmon.lib
DLL	Urlmon.dll