다음을 통해 공유


DSOP_SCOPE_INIT_INFO 구조체(objsel.h)

DSOP_SCOPE_INIT_INFO 구조체는 동일한 특성을 가진 하나 이상의 scope 형식을 설명합니다. scope 형식은 사용자가 개체를 선택할 수 있는 위치 유형(예: 도메인, 컴퓨터 또는 글로벌 카탈로그)입니다. 이 구조체는 IDsObjectPicker::Initialize를 호출할 때 DSOP_INIT_INFO 사용됩니다.

구문

typedef struct _DSOP_SCOPE_INIT_INFO {
  ULONG             cbSize;
  ULONG             flType;
  ULONG             flScope;
  DSOP_FILTER_FLAGS FilterFlags;
  PCWSTR            pwzDcName;
  PCWSTR            pwzADsPath;
  HRESULT           hr;
} DSOP_SCOPE_INIT_INFO, *PDSOP_SCOPE_INIT_INFO;

멤버

cbSize

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

flType

이 구조체에서 설명하는 scope 형식을 나타내는 플래그입니다. 지정된 모든 범위가 동일한 설정을 사용하는 경우 여러 scope 형식을 결합할 수 있습니다. 이 멤버는 다음 플래그의 조합일 수 있습니다.

DSOP_SCOPE_TYPE_TARGET_COMPUTER(0x00000001)

DSOP_INIT_INFO 구조체의 pwzTargetComputer 멤버로 지정된 컴퓨터입니다.

대상 컴퓨터가 상위 수준 또는 하위 수준 도메인 컨트롤러인 경우 DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK 플래그가 DSOP_INIT_INFO구조의flOptions 멤버에 설정되지 않는 한 이 플래그는 무시됩니다.

DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN(0x00000002)

대상 컴퓨터가 조인되는 상위 수준 도메인입니다. 이 플래그가 설정된 경우 pwzDcName 멤버를 사용하여 가입된 도메인에서 도메인 컨트롤러의 이름을 지정합니다.

DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN(0x00000004)

대상 컴퓨터가 조인되는 하위 수준 도메인입니다.

DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN(0x00000008)

대상 컴퓨터가 속한 엔터프라이즈의 모든 도메인입니다. DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN scope 지정하면 DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN scope 조인된 도메인을 제외한 엔터프라이즈의 모든 도메인을 나타냅니다.

DSOP_SCOPE_TYPE_GLOBAL_CATALOG(0x00000010)

엔터프라이즈의 모든 도메인에서 개체를 포함하는 scope. 엔터프라이즈는 상위 수준 도메인만 포함할 수 있습니다.

DSOP_SCOPE_TYPE_EXTERNAL_UPLEVEL_DOMAIN(0x00000020)

엔터프라이즈 외부에 있지만 대상 컴퓨터가 조인된 도메인에서 신뢰할 수 있는 모든 상위 수준 도메인입니다.

DSOP_SCOPE_TYPE_EXTERNAL_DOWNLEVEL_DOMAIN(0x00000040)

엔터프라이즈 외부의 모든 하위 수준 도메인이지만 대상 컴퓨터가 조인된 도메인에서 신뢰할 수 있습니다.

DSOP_SCOPE_TYPE_WORKGROUP(0x00000080)

대상 컴퓨터가 조인되는 작업 그룹입니다. 대상 컴퓨터가 도메인에 가입되지 않은 경우에만 적용됩니다.

작업 그룹에서 선택할 수 있는 유일한 개체 유형은 컴퓨터입니다.

DSOP_SCOPE_TYPE_USER_ENTERED_UPLEVEL_SCOPE(0x00000100)

사용자가 상위 수준 scope 입력할 수 있도록 합니다. DSOP_SCOPE_TYPE_USER_ENTERED_* 형식 중 어느 것도 지정하지 않으면 대화 상자에서 사용자를 보기 드롭다운 목록의 범위로 제한합니다.

DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE(0x00000200)

사용자가 하위 수준 scope 입력할 수 있도록 합니다.

flScope

이 scope 선택한 개체에 대해 ADsPath를 반환하는 데 사용되는 형식을 나타내는 플래그입니다. flScope 멤버는 Look in 드롭다운 목록에 표시되는 초기 scope 나타낼 수도 있습니다. 이 멤버는 다음 플래그의 조합일 수 있습니다.

LDAP 및 GC(글로벌 카탈로그) 경로를 WinNT ADsPath 구문으로 변환할 수 있습니다. GC 경로는 LDAP 형식으로 변환할 수 있습니다. DSOP_SCOPE_FLAG_WANT_SID_PATH 또는DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP 플래그를 지정하는 경우 objectSid 특성을 가진 WinNT 개체를 LDAP 형식으로 변환할 수 있습니다. 다른 변환은 합법적이 아닙니다.

DSOP_SCOPE_FLAG_STARTING_SCOPE(0x00000001)

이 구조체에서 설명하는 scope 처음에 보기 드롭다운 목록에서 선택됩니다. scope 하나만 이 플래그를 지정할 수 있습니다. 이 플래그를 지정하는 scope 없는 경우 초기 scope IDsObjectPicker::Initialize 메서드에 전달된 범위 배열에서 처음으로 성공적으로 생성된 scope.

DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT(0x00000002)

ADsPaths는 WinNT 공급자를 사용하도록 변환됩니다. 자세한 내용은 WinNT ADsPath를 참조하세요.

DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP(0x00000004)

ADsPaths는 LDAP 공급자를 사용하도록 변환됩니다. 자세한 내용은 LDAP ADsPath를 참조하세요.

DSOP_SCOPE_FLAG_WANT_PROVIDER_GC(0x00000008)

이 scope 선택한 개체에 대한 ADsPaths는 GC 공급자를 사용하도록 변환됩니다.

DSOP_SCOPE_FLAG_WANT_SID_PATH(0x00000010)

objectSid 특성이 있는 ADsPaths는 LDAP://< SID=x> 형식으로 변환됩니다. 여기서 x는 objectSid 특성 값의 16진수 숫자를 나타냅니다.

DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH(0x00000020)

이 플래그를 지정하지 않는 한 하위 수준의 잘 알려진 SID 개체에 대한 ADsPaths는 빈 문자열입니다(예: DSOP_DOWNLEVEL_FILTER_INTERACTIVE). 이 플래그를 지정하면 경로에 양식이 있습니다.

AUTHORITY/Interactive 또는 WinNT://Creator 소유자를 WinNT://NT.

DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS(0x00000040)

scope 필터에 사용자가 포함된 경우 대화 상자에서 사용자 검사 상자를 선택합니다.

DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS(0x00000080)

scope 필터에 그룹이 포함된 경우 대화 상자에서 그룹 검사 상자를 선택합니다.

DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS(0x00000100)

scope 필터에 컴퓨터가 포함된 경우 대화 상자에서 컴퓨터 검사 상자를 선택합니다.

DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS(0x00000200)

scope 필터에 연락처가 포함된 경우 대화 상자에서 연락처 검사 상자를 선택합니다.

DSOP_SCOPE_FLAG_DEFAULT_FILTER_SERVICE_ACCOUNTS(0x00000400)

scope 필터에 서비스 계정이 포함된 경우 대화 상자에서 서비스 계정그룹 관리 서비스 계정 검사 상자를 선택합니다.

DSOP_SCOPE_FLAG_DEFAULT_FILTER_PASSWORDSETTINGS_OBJECTS(0x00000800)

scope 필터에 암호 설정 개체가 포함된 경우 대화 상자에서 암호 설정 개체 검사 상자를 선택합니다.

FilterFlags

scope 또는 범위에 대해 사용자에게 표시되는 개체의 형식을 나타내는 DSOP_FILTER_FLAGS 구조체를 포함합니다.

pwzDcName

대상 컴퓨터가 조인된 도메인의 도메인 컨트롤러 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 멤버는 flType 멤버에 DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN 플래그가 포함된 경우에만 사용됩니다. 해당 플래그가 설정되지 않은 경우 pwzDcNameNULL이어야 합니다.

이 멤버는 DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN 플래그가 지정된 경우에도 NULL일 수 있습니다. 이 경우 대화 상자가 도메인 컨트롤러를 조회합니다. 이 멤버를 사용하면 멀티마스터 도메인의 특정 도메인 컨트롤러 이름을 지정할 수 있습니다. 예를 들어 관리 애플리케이션은 다중 마스터 도메인의 도메인 컨트롤러에서 변경한 다음 다른 도메인 컨트롤러에서 변경 내용이 복제되기 전에 개체 선택기 대화 상자를 열 수 있습니다.

pwzADsPath

예약; 은 NULL이어야 합니다.

hr

특정 scope 상태 나타내는 HRESULT 값을 포함합니다. IDsObjectPicker::Initialize 메서드가 이 구조체에 지정된 scope 또는 범위를 성공적으로 만드는 경우 hr에는 S_OK 포함됩니다. 그렇지 않으면 hr 에 오류 코드가 포함됩니다.

IDsObjectPicker::InitializeS_OK 반환하는 경우 지정된 모든 DSOP_SCOPE_INIT_INFO 구조체의 hr 멤버에도 S_OK 포함됩니다.

요구 사항

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

추가 정보

DSOP_FILTER_FLAGS

DSOP_INIT_INFO

디렉터리 개체 선택기

IDsObjectPicker::Initialize