BuildTrusteeWithObjectsAndSidA 函式 (aclapi.h)

發行項
02/28/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 結構的指標，描述要加入至 TRUSTEE 結構的 ObjectType GUID。

[in, optional] pInheritedObjectGuid

GUID 結構的指標，描述要加入至 TRUSTEE 結構的 InheritedObjectType GUID。

[in, optional] pSid

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

傳回值

無

備註

此函式不會為 TRUSTEE 和 OBJECTS_AND_SID 結構配置記憶體。

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

注意

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

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	aclapi.h
程式庫	Advapi32.lib
Dll	Advapi32.dll