DSOP_INIT_INFO 구조체(objsel.h)

DSOP_INIT_INFO 구조에는 개체 선택 대화 상자를 초기화하는 데 필요한 데이터가 포함되어 있습니다. 이 구조체는 IDsObjectPicker::Initialize 메서드와 함께 사용됩니다.

구문

typedef struct _DSOP_INIT_INFO {
  ULONG                 cbSize;
  PCWSTR                pwzTargetComputer;
  ULONG                 cDsScopeInfos;
  PDSOP_SCOPE_INIT_INFO aDsScopeInfos;
  ULONG                 flOptions;
  ULONG                 cAttributesToFetch;
  PCWSTR                *apwzAttributeNames;
} DSOP_INIT_INFO, *PDSOP_INIT_INFO;

멤버

cbSize

구조체의 크기(바이트)를 포함합니다.

pwzTargetComputer

대상 컴퓨터의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 대화 상자는 대상 컴퓨터에서 실행되는 것처럼 작동하며 대상 컴퓨터를 사용하여 조인된 도메인 및 엔터프라이즈를 확인합니다. 이 값이 NULL이면 대상 컴퓨터가 로컬 컴퓨터입니다.

cDsScopeInfos

aDsScopeInfos 배열의 요소 수를 지정합니다.

aDsScopeInfos

사용자가 개체를 선택할 수 있는 범위를 설명하는 DSOP_SCOPE_INIT_INFO 구조체 배열에 대한 포인터입니다. 이 멤버는 NULL일 수 없으며 개체 선택기가 하나 이상의 scope 없이 작동할 수 없으므로 배열에 하나 이상의 요소가 포함되어야 합니다.

flOptions

개체 선택기 옵션을 결정하는 플래그입니다. 이 멤버는 0이거나 다음 플래그 중 하나 이상의 조합일 수 있습니다.

DSOP_FLAG_MULTISELECT(0x00000001)

이 플래그가 설정되면 사용자는 여러 개체를 선택할 수 있습니다. 이 플래그가 설정되지 않은 경우 사용자는 하나의 개체만 선택할 수 있습니다.

DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK(0x00000002)

이 플래그가 설정되고 aDsScopeInfos 배열에서 DSOP_SCOPE_TYPE_TARGET_COMPUTER 플래그가 설정된 경우 대상 컴퓨터는 항상 Look in 드롭다운 목록에 포함됩니다.

이 플래그가 설정되지 않고 대상 컴퓨터가 상위 수준 또는 하위 수준 도메인 컨트롤러인 경우 DSOP_SCOPE_TYPE_TARGET_COMPUTER 플래그가 무시되고 대상 컴퓨터가 보기 드롭다운 목록에 포함되지 않습니다.

초기화 중에 시간을 절약하려면 대상 컴퓨터가 도메인 컨트롤러가 아닌 것으로 알려진 경우 이 플래그를 설정해야 합니다. 그러나 대상 컴퓨터가 도메인 컨트롤러인 경우 사용자가 도메인 컨트롤러 자체가 아닌 도메인 scope 도메인 개체를 선택하는 것이 더 낫기 때문에 이 플래그를 설정해서는 안 됩니다.

cAttributesToFetch

apwzAttributeNames 배열의 요소 수를 포함합니다. 이 멤버는 0일 수 있습니다.

apwzAttributeNames

선택한 각 개체에 대해 검색할 특성의 이름을 포함하는 null로 끝나는 유니코드 문자열 배열에 대한 포인터입니다. cAttributesToFetch가 0이면 이 멤버는 무시됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
머리글	objsel.h

추가 정보

DSOP_SCOPE_INIT_INFO

디렉터리 개체 선택기

IDsObjectPicker::Initialize