BuildTrusteeWithObjectsAndNameA 函式（aclapi.h）

發行項
11/20/2024

BuildTrusteeWithObjectsAndName 函式會使用特定物件訪問控制專案（ACE）資訊初始化 TRUST 結構，並將結構的其餘成員初始化為預設值。呼叫端也會指定信任項的名稱。

語法

void BuildTrusteeWithObjectsAndNameA(
  [in, out]      PTRUSTEE_A          pTrustee,
  [in, optional] POBJECTS_AND_NAME_A pObjName,
  [in, optional] SE_OBJECT_TYPE      ObjectType,
  [in, optional] LPSTR               ObjectTypeName,
  [in, optional] LPSTR               InheritedObjectTypeName,
  [in, optional] LPSTR               Name
);

參數

[in, out] pTrustee

由此函式初始化之 TRUSTEE 結構的指標。如果此參數的值 NULL 或無效的指標，則結果為未定義。

[in, optional] pObjName

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

[in, optional] ObjectType

SE_OBJECT_TYPE 列舉的指標，其中包含安全性實體物件類型的相關信息。

[in, optional] ObjectTypeName

字串的指標，指定要新增至 pTrustee 參數中傳回之 TRUST 結構之 ObjectType GUID 的名稱。此函式會決定對應至此名稱的 ObjectType GUID。

[in, optional] InheritedObjectTypeName

字串的指標，指定要新增至 pTrustee 參數中所傳回之 TRUST 結構之 InheritedObjectType GUID 的名稱。此函式會決定對應於此名稱的 InheritedObjectType GUID。

[in, optional] Name

字串的指標，指定用來識別信任項的名稱。

傳回值

沒有

言論

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

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

注意

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

要求

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