共用方式為


BuildTrusteeWithSidA 函式 (aclapi.h)

BuildTrusteeWithSid 函式會初始化TRUST 結構。 呼叫端會指定信任者 (SID) 的安全性識別碼 。 函式會將 結構的其他成員設定為預設值,而且不會查閱與 SID 相關聯的名稱。

語法

void BuildTrusteeWithSidA(
  [in, out]      PTRUSTEE_A pTrustee,
  [in, optional] PSID       pSid
);

參數

[in, out] pTrustee

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

[in, optional] pSid

識別信任項的 SID 結構的指標。 BuildTrusteeWithSid 函式會將這個指標指派給TRUST 結構的 ptstrName 成員。 函式會設定 所信任 結構的其他成員,如下所示。

意義
pMultipleTrustee
NULL
MultipleTrusteeOperation
NO_MULTIPLE_TRUSTEE
TrusteeForm
TRUSTEE_IS_SID
TrusteeType
TRUSTEE_IS_UNKNOWN

傳回值

備註

注意

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

規格需求

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

另請參閱

存取控制 概觀

基本 存取控制 函式

BuildTrusteeWithName

BuildTrusteeWithObjectsAndName

BuildTrusteeWithObjectsAndSid

受託 人