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.

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

See also

IInternetSecurityManager::GetSecurityId