EqualDomainSid 函式 (securitybaseapi.h)

  • 發行項

EqualDomainSid 函式會判斷兩個 SID 是否來自相同的網域。

語法

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

參數

[in] pSid1

要比較的兩個SID之一的指標。 此 SID 必須是帳戶網域 SID 或 BUILTIN SID。

[in] pSid2

要比較的兩個SID之一的指標。 此 SID 必須是帳戶網域 SID 或 BUILTIN SID。

[out] pfEqual

如果兩個 SID 的網域相等， 則 EqualDomainSid 設定為 TRUE 的 BOOL 指標，如果兩個 SID 的網域不相等，則為 FALSE 。 這個值不可以是 NULL。

傳回值

如果兩個 SID 都是帳戶網域 SID 和/或 BUILTIN SID，則傳回值為非零值。 此外，如果兩個 SID 的網域相等，*pfEqual 會設定為 TRUE ;否則*pfEqual 會設定為 FALSE。

如果一或多個 SIDS 不是帳戶網域 SID 或 BUILTIN SID，則傳回值為 FALSE。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。 如果 SID 不是帳戶網域 SID 或 BUILTIN SID，GetLastError 會傳回ERROR_NON_DOMAIN_SID。

規格需求

需求 值
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 securitybaseapi.h (包含 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

EqualPrefixSid

EqualSid