BuildTrusteeWithObjectsAndSidA 函式（aclapi.h）

發行項
11/20/2024

BuildTrusteeWithObjectsAndSid 函式會使用物件特定的存取控制專案（ACE）資訊，初始化結構其餘成員為預設值的 TRUST 結構。呼叫端也會指定 SID 結構，此結構代表信任項安全性識別碼。

語法

void BuildTrusteeWithObjectsAndSidA(
  [in, out]      PTRUSTEE_A       pTrustee,
  [in, optional] POBJECTS_AND_SID pObjSid,
  [in, optional] GUID             *pObjectGuid,
  [in, optional] GUID             *pInheritedObjectGuid,
  [in, optional] PSID             pSid
);

參數

[in, out] pTrustee

要初始化之信任結構的指標。 BuildTrusteeWithObjectsAndSid 函式不會配置任何記憶體。如果此參數 NULL 或無效的指標，則結果為未定義。

[in, optional] pObjSid

OBJECTS_AND_SID 結構的指標，其中包含信任項和安全性實體對象的相關信息。

[in, optional] pObjectGuid

GUID 結構的指標，描述要加入至信任結構的 ObjectType GUID。

[in, optional] pInheritedObjectGuid

GUID 結構的指標，描述要新增至 TRUSTEE 結構的 InheritedObjectType GUID。

[in, optional] pSid

識別信任項之 SID 結構的指標。

傳回值

沒有

言論

此函式不會配置記憶體給信任和 OBJECTS_AND_SID 結構。

如需物件特定 ACE 的詳細資訊，請參閱物件特定的 ACE。

注意

aclapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 BuildTrusteeWithObjectsAndSid 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	aclapi.h
連結庫	Advapi32.lib
DLL	Advapi32.dll