ISecurityInformation2：：LookupSids 方法 (aclui.h)

發行項
02/26/2024

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