ADS_PREFERENCES_ENUM 열거형(iads.h)

아티클
02/28/2024

ADS_PREFERENCES_ENUM 열거형은 ADSI용 OLE DB 공급자의 쿼리 기본 설정을 지정합니다.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0022 {
  ADSIPROP_ASYNCHRONOUS = 0,
  ADSIPROP_DEREF_ALIASES = 0x1,
  ADSIPROP_SIZE_LIMIT = 0x2,
  ADSIPROP_TIME_LIMIT = 0x3,
  ADSIPROP_ATTRIBTYPES_ONLY = 0x4,
  ADSIPROP_SEARCH_SCOPE = 0x5,
  ADSIPROP_TIMEOUT = 0x6,
  ADSIPROP_PAGESIZE = 0x7,
  ADSIPROP_PAGED_TIME_LIMIT = 0x8,
  ADSIPROP_CHASE_REFERRALS = 0x9,
  ADSIPROP_SORT_ON = 0xa,
  ADSIPROP_CACHE_RESULTS = 0xb,
  ADSIPROP_ADSIFLAG = 0xc
} ADS_PREFERENCES_ENUM;

상수


`ADSIPROP_ASYNCHRONOUS` 값: 0 비동기 검색을 요청합니다.
`ADSIPROP_DEREF_ALIASES` 값: 0x1 찾은 개체의 별칭을 확인하도록 지정합니다. ADS_DEREFENUM 사용하여 이 작업을 수행하는 방법을 지정합니다.
`ADSIPROP_SIZE_LIMIT` 값: 0x2 서버가 검색에서 관찰해야 하는 크기 제한을 지정합니다. 크기 제한은 반환된 개체의 최대 수입니다. 값이 0이면 크기 제한이 부과되지 않음을 나타냅니다. 크기 제한에 도달하면 서버가 검색을 중지하고 해당 시점까지 누적된 결과를 반환합니다.
`ADSIPROP_TIME_LIMIT` 값: 0x3 서버가 검색에서 관찰해야 하는 시간 제한(초)을 지정합니다. 값이 0이면 시간 제한 제한이 부과되지 않음을 나타냅니다. 시간 제한에 도달하면 서버는 검색을 중지하고 해당 지점에 누적된 결과를 반환합니다.
`ADSIPROP_ATTRIBTYPES_ONLY` 값: 0x4 검색에서 값이 할당된 특성의 이름만 가져와야 했음을 나타냅니다.
`ADSIPROP_SEARCH_SCOPE` 값: 0x5 서버에서 관찰해야 하는 검색 scope 지정합니다. 적절한 설정에 대한 자세한 내용은 ADS_SCOPEENUM 열거형을 참조하세요.
`ADSIPROP_TIMEOUT` 값: 0x6 클라이언트가 서버가 결과를 반환할 때까지 대기하는 시간 제한(초)을 지정합니다.
`ADSIPROP_PAGESIZE` 값: 0x7 페이징된 검색에서 페이지 크기를 지정합니다. 클라이언트의 각 요청에 대해 서버는 페이지 크기에 따라 설정된 개체 수를 반환합니다.
`ADSIPROP_PAGED_TIME_LIMIT` 값: 0x8 서버가 결과 페이지를 검색하기 위해 관찰해야 하는 시간 제한(초)을 지정합니다. 이는 전체 검색에 대한 시간 제한과 반대됩니다.
`ADSIPROP_CHASE_REFERRALS` 값: 0x9 조회를 쫓을 수 있도록 지정합니다. 루트 검색이 서버의 명명 컨텍스트에 지정되지 않았거나 검색 결과가 명명 컨텍스트를 넘을 때(예: 자식 도메인이 있고 부모 도메인에서 검색하는 경우) 서버는 클라이언트가 무시하거나 추적하도록 선택할 수 있는 조회 메시지를 클라이언트에 보냅니다. 기본적으로 이 옵션은 ADS_CHASE_REFERRALS_EXTERNAL 설정됩니다. 조회 추적에 대한 자세한 내용은 ADS_CHASE_REFERRALS_ENUM 참조하세요.
`ADSIPROP_SORT_ON` 값: 0xa 서버가 결과 집합을 정렬하도록 지정합니다. ADS_SORTKEY 구조를 사용하여 정렬 키를 지정합니다.
`ADSIPROP_CACHE_RESULTS` 값: 0xb 결과를 클라이언트 쪽에서 캐시해야 하는지를 지정합니다. 기본적으로 ADSI는 결과 집합을 캐시합니다. 이 옵션을 해제하는 것이 큰 결과 집합에 더 적합할 수 있습니다.
`ADSIPROP_ADSIFLAG` 값: 0xc OLEDB 클라이언트가 서버에 바인딩할 때 사용할 바인딩 플래그를 지정할 수 있습니다. 유효한 값은 ADsOpenObject에서 허용하는 값입니다. 속성 이름 "ADSI 플래그"를 사용하여 ADO 스크립트에서 액세스합니다.

설명

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