DS_SELECTION 구조체(objsel.h)

아티클
08/25/2023

DS_SELECTION 구조체에는 사용자가 개체 선택 대화 상자에서 선택한 개체에 대한 데이터가 포함됩니다. DS_SELECTION_LIST 구조체에는 DS_SELECTION 구조체의 배열이 포함됩니다.

구문

typedef struct _DS_SELECTION {
  PWSTR   pwzName;
  PWSTR   pwzADsPath;
  PWSTR   pwzClass;
  PWSTR   pwzUPN;
  VARIANT *pvarFetchedAttributes;
  ULONG   flScopeType;
} DS_SELECTION, *PDS_SELECTION;

멤버

pwzName

개체의 RDN(상대 고유 이름)을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

pwzADsPath

개체의 ADsPath를 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 문자열의 형식은 이 개체가 선택된 scope 대한 DSOP_SCOPE_INIT_INFO 구조체의 flScope 멤버에 지정된 플래그에 따라 달라집니다.

pwzClass

개체의 objectClass 특성 값을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

pwzUPN

개체의 userPrincipalName 특성 값이 포함된 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 개체에 userPrincipalName 값이 없는 경우 pwzUPN 은 빈 문자열(L"")을 가리킵니다.

pvarFetchedAttributes

VARIANT 구조체의 배열에 대한 포인터입니다. 각 VARIANT 에는 선택한 개체의 특성 값이 포함됩니다. 검색된 특성은 IDsObjectPicker::Initialize 메서드에 전달된 DSOP_INIT_INFO 구조체의 apwzAttributeNames 멤버에 지정된 특성 이름에 따라 결정됩니다. pvarFetchedAttributes 배열의 특성 순서는 apwzAttributeNames 배열에 지정된 특성 이름의 순서에 해당합니다.

개체 선택 대화 상자가 요청된 특성을 검색하지 못할 수 있습니다. 특성을 검색할 수 없는 경우 VARIANT 구조의 vt 멤버에는 VT_EMPTY 포함됩니다.

flScopeType

이 개체가 선택된 scope 유형을 나타내는 DSOP_SCOPE_TYPE_ 하나 이상을 포함합니다. 자세한 내용과 DSOP_SCOPE_TYPE_ 플래그 목록은 DSOP_SCOPE_INIT_INFO구조체의 flType 멤버를 참조하세요.