Функция EqualDomainSid (securitybaseapi.h)

Статья
08/25/2023

Функция EqualDomainSid определяет, относятся ли два идентификатора безопасности к одному домену.

Синтаксис

BOOL EqualDomainSid(
  [in]  PSID pSid1,
  [in]  PSID pSid2,
  [out] BOOL *pfEqual
);

Параметры

[in] pSid1

Указатель на один из двух сравниваемых идентификаторов безопасности. Этот идентификатор безопасности должен быть идентификатором безопасности домена учетной записи или SID BUILTIN.

[in] pSid2

[out] pfEqual

Указатель на логический код, который EqualDomainSid присваивает значение TRUE , если домены двух идентификаторов безопасности равны, или FALSE , если они не равны. Это значение не может иметь значение NULL.

Возвращаемое значение

Если оба идентификатора безопасности являются идентификаторами БЕЗОПАСНОСТИ домена учетной записи и (или) ВСТРОЕННЫМИ идентификаторами SID, возвращаемое значение не равно нулю. Кроме того, *pfEqual имеет значение TRUE , если домены двух идентификаторов безопасности равны; В противном случае параметр *pfEqual имеет значение FALSE.

Если один или несколько sids не являются ни идентификатором безопасности домена учетной записи, ни идентификатором БЕЗОПАСНОСТИ BUILTIN, то возвращаемое значение равно FALSE. Дополнительные сведения об ошибке можно получить, вызвав GetLastError. GetLastError возвращает ERROR_NON_DOMAIN_SID, если идентификатор безопасности не является идентификатором безопасности домена учетной записи или SID BUILTIN.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	securitybaseapi.h (включая Windows.h)
Библиотека	Advapi32.lib
DLL	Advapi32.dll

См. также раздел

EqualPrefixSid

EqualSid