EqualDomainSid-Funktion (securitybaseapi.h)

  • Artikel

Die EqualDomainSid-Funktion bestimmt, ob zwei SIDs aus derselben Domäne stammen.

Syntax

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

Parameter

[in] pSid1

Ein Zeiger auf eine der beiden zu vergleichenden SIDs. Diese SID muss entweder eine Kontodomänen-SID oder eine BUILTIN-SID sein.

[in] pSid2

Ein Zeiger auf eine der beiden zu vergleichenden SIDs. Diese SID muss entweder eine Kontodomänen-SID oder eine BUILTIN-SID sein.

[out] pfEqual

Ein Zeiger auf eine BOOL, die EqualDomainSid auf TRUE festlegt, wenn die Domänen der beiden SIDs gleich sind, oder FALSE , wenn sie ungleich sind. Dieser Wert darf nicht NULL sein.

Rückgabewert

Wenn es sich bei beiden SIDs um Kontodomänen-SIDs und/oder BUILTIN-SIDs handelt, ist der Rückgabewert ungleich null. Darüber hinaus wird *pfEqual auf TRUE festgelegt, wenn die Domänen der beiden SIDs gleich sind. Andernfalls ist *pfEqual auf FALSE festgelegt.

Wenn mindestens eine der SIDS weder eine Kontodomänen-SID noch eine BUILTIN-SID ist, ist der Rückgabewert FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. GetLastError gibt ERROR_NON_DOMAIN_SID zurück, wenn die SID keine Kontodomänen-SID oder BUILTIN-SID ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile securitybaseapi.h (Einschließen von Windows.h)
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

EqualPrefixSid

EqualSid