ADS_SCOPEENUM 열거형(iads.h)

아티클
02/29/2024

ADS_SCOPEENUM 열거형은 디렉터리 검색의 scope 지정합니다.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0021 {
  ADS_SCOPE_BASE = 0,
  ADS_SCOPE_ONELEVEL = 1,
  ADS_SCOPE_SUBTREE = 2
} ADS_SCOPEENUM;

상수


`ADS_SCOPE_BASE` 값: 0 검색을 기본 개체로 제한합니다. 결과에는 최대 하나의 개체가 포함됩니다.
`ADS_SCOPE_ONELEVEL` 값: 1 기본 개체를 제외한 직속 자식의 한 수준을 검색합니다.
`ADS_SCOPE_SUBTREE` 값: 2 모든 자식 및 기본 개체 자체를 포함하여 전체 하위 트리를 검색합니다.

설명

검색 scope 명시적으로 설정하지 않으면 기본값은 ADS_SCOPE_SUBTREE.

VBScript는 형식 라이브러리에서 데이터를 읽을 수 없으므로 VBScript 애플리케이션은 위에서 정의한 대로 기호 상수를 인식하지 않습니다. 대신 숫자 상수를 사용하여 VBScript 애플리케이션에서 적절한 플래그를 설정합니다. 심볼 상수를 좋은 프로그래밍 사례로 사용하려면 VBScript 애플리케이션에서 여기에서와 같이 이러한 상수에 대한 명시적 선언을 만듭니다.

예제

검색 scope 클라이언트가 지정할 수 있는 검색 기본 설정 중 하나입니다. 다음 코드 예제에서는 ADS_SEARCHPREF_ENUM 정의된 요소 및 이 열거형과 함께 ADS_SEARCHPREF_INFO 구조를 사용하여 이 작업을 수행하는 방법을 보여 줍니다.

ADS_SEARCHPREF_INFO prefInfo;
prefInfo.dwSearchPref = ADS_SEARCHPREF_SEARCH_SCOPE;
prefInfo.vValue.dwType = ADSTYPE_INTEGER;
prefInfo.vValue.Integer = ADS_SCOPE_SUBTREE;