ISecurityInformation2::LookupSids 메서드(aclui.h)
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 |