LookupSecurityDescriptorPartsA 函式 (aclapi.h)

發行項
02/28/2024

LookupSecurityDescriptorParts 函式會從自我相對安全性描述元擷取安全性資訊。

語法

DWORD LookupSecurityDescriptorPartsA(
  [out, optional] PTRUSTEE_A           *ppOwner,
  [out, optional] PTRUSTEE_A           *ppGroup,
  [out, optional] PULONG               pcCountOfAccessEntries,
  [out, optional] PEXPLICIT_ACCESS_A   *ppListOfAccessEntries,
  [out, optional] PULONG               pcCountOfAuditEntries,
  [out, optional] PEXPLICIT_ACCESS_A   *ppListOfAuditEntries,
  [in]            PSECURITY_DESCRIPTOR pSD
);

參數

[out, optional] ppOwner

變數的指標，可接收對 TRUSTEE 結構的指標。函式會在 pSD 安全性描述元中查閱與擁有者安全性標識符相關聯的名稱， (SID) ，並傳回在 TRUSTEE 結構的 ptstrName 成員中名稱的指標。函式會將 TrusteeForm 成員設定為 TRUSTEE_IS_NAME。

如果您對擁有者的名稱不感興趣，此參數可以是 NULL 。

[out, optional] ppGroup

變數的指標，可接收對 TRUSTEE 結構的指標。此函式會查閱與安全描述元之主要群組 SID 相關聯的名稱，並傳回在 TRUSTEE 結構之 ptstrName 成員中名稱的指標。函式會將 TrusteeForm 成員設定為 TRUSTEE_IS_NAME。

如果您對組名不感興趣，這個參數可以是 NULL 。

[out, optional] pcCountOfAccessEntries

ULONG 的指標，接收 pListOfAccessEntries 陣列中傳回的EXPLICIT_ACCESS結構數目。 只有當pListOfAccessEntries 參數也是 NULL 時，此參數才能是 NULL。

[out, optional] ppListOfAccessEntries

變數的指標，該變數會接收EXPLICIT_ACCESS結構的指標，該陣列描述安全性描述元 (DACL) 之選擇性存取控制清單中的存取控制專案 (ACE) 。這些EXPLICIT_ACCESS結構中的TRUSTEE結構會使用TRUSTEE_IS_NAME形式。如需 EXPLICIT_ACCESS 結構的數位如何描述訪問控制清單中的 ACE (ACL) ，請參閱 GetExplicitEntriesFromAcl 函式。如果此參數為 NULL，cCountOfAccessEntries 參數也必須是 NULL。

[out, optional] pcCountOfAuditEntries

ULONG 的指標，可接收 pListOfAuditEntries 陣列中傳回的EXPLICIT_ACCESS結構數目。 只有當pListOfAuditEntries 參數也是 NULL 時，此參數才能是 NULL。

[out, optional] ppListOfAuditEntries

變數的指標，接收 EXPLICIT_ACCESS 結構數位的指標，這些結構描述系統訪問控制清單中的 ACE (SACL) 安全性描述元。這些EXPLICIT_ACCESS結構中的TRUSTEE結構會使用TRUSTEE_IS_NAME形式。如果此參數為 NULL，cCountOfAuditEntries 參數也必須是 NULL。

[in] pSD

函式從中擷取安全性資訊的現有自我相對安全性描述元指標。

傳回值

如果函式成功，函式會傳回ERROR_SUCCESS。

如果函式失敗，它會傳回 WinError.h 中定義的非零錯誤碼。

備註

LookupSecurityDescriptorParts 函式會擷取安全性描述元的擁有者和主要群組的名稱。此函式也會傳回 DACL 中 ACE 的描述，以及安全性描述元之 SACL 中的稽核控制專案描述。

如果您對資訊不感興趣， pSD 以外的參數可以是 NULL 。如果您不想要 DACL 的相關信息， pListOfAccessEntries 和 cCountOfAuditEntries 都必須是 NULL。如果您不想要 SACL 的相關信息， pListOfAuditEntries 和 cCountOfAuditEntries 都必須是 NULL。同樣地，如果您想要 DACL 或 SACL 資訊，則兩個對應的參數不得為 NULL。

當您完成使用 pOwner、 pGroup、 pListOfAccessEntries 或 pListOfAuditEntries 參數傳回的任何緩衝區時，請呼叫 LocalFree 函式來釋放這些緩衝區。

LookupSecurityDescriptorParts 函式適用於在自己的對象上實作或公開安全性的信任伺服器。函式適用於自我相對安全性描述元，適合串行化為數據流並儲存至磁碟，因為信任的伺服器可能需要。

注意

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

規格需求

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