ISecurityInformation2：：LookupSids 方法 (aclui.h)
LookupSids 方法會傳回對應至指定 SID 清單中每個元素的通用名稱。
語法
HRESULT LookupSids(
[in] ULONG cSids,
[in] PSID *rgpSids,
[out] LPDATAOBJECT *ppdo
);
參數
[in] cSids
rgpSids 所指向之 SID 結構的指標數目。
[in] rgpSids
SID 結構的指標陣列指標。
[out] ppdo
指向傳回之數據傳輸物件的指標，其中包含 SID 的一般名稱。 選擇性地，此參數也會傳回 rgpSids 參數中 SID 的用戶主體名稱 (UPN) 。 數據傳輸對像是 SID_INFO 結構。
傳回值
如果成功，則傳回S_OK。
如果發生錯誤，則傳回非零錯誤碼。
備註
如果訪問控制編輯器決定對應至指定 SID 的通用名稱， 則 LookupSids 的實作可以傳回E_NOTIMPL。 不過，如果訪問控制編輯器收到S_OK以外的任何傳回碼，編輯器會決定這項資訊。
用戶端必須使用下列格式，透過資料對象傳回通用名稱。
#include <windows.h>
// HGLOBAL containing SID_INFO_LIST returned by
// ISecurityInformation2::LookupSids
#define CFSTR_ACLUI_SID_INFO_LIST TEXT("CFSTR_ACLUI_SID_INFO_LIST")
// Data structures corresponding to CFSTR_ACLUI_SID_INFO_LIST
typedef struct _SID_INFO
{
PSID pSid;
PWSTR pwzCommonName;
PWSTR pwzClass; // Used for selecting icon, for example,
// "User" or "Group"
PWSTR pwzUPN; // Optional pointer to a user principal
// name
} SID_INFO, *PSID_INFO;
typedef struct _SID_INFO_LIST
{
ULONG cItems;
SID_INFO aSidInfo[ANYSIZE_ARRAY];
} SID_INFO_LIST, *PSID_INFO_LIST;
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | aclui.h |