ISecurityInformation2::LookupSids 메서드(aclui.h)

아티클
02/23/2024

LookupSids 메서드는 지정된 SID 목록에 있는 각 요소에 해당하는 일반 이름을 반환합니다.

구문

HRESULT LookupSids(
  [in]  ULONG        cSids,
  [in]  PSID         *rgpSids,
  [out] LPDATAOBJECT *ppdo
);

매개 변수

[in] cSids

rgpSid가 가리키는 SID 구조체에 대한 포인터 수입니다.

[in] rgpSids

SID 구조체에 대한 포인터 배열에 대한 포인터입니다.

[out] ppdo

SID의 일반 이름을 포함하는 반환된 데이터 전송 개체에 대한 포인터에 대한 포인터입니다. 필요에 따라 이 매개 변수는 rgpSids 매개 변수에서 SID의 UPN(사용자 계정 이름)도 반환합니다. 데이터 전송 개체는 SID_INFO 구조체입니다.

반환 값

성공하면 S_OK 반환합니다.

오류가 발생하면 0이 아닌 오류 코드를 반환합니다.

설명

LookupSids 구현은 액세스 제어 편집기가 지정된 SID에 해당하는 일반 이름을 결정하는 경우 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