ADS_STATUSENUM 열거형(iads.h)

아티클
03/02/2024

ADS_STATUSENUM 열거형은 IDirectorySearch::SetSearchPreference 메서드를 사용하여 검색 기본 설정 집합의 상태 지정합니다.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0019 {
  ADS_STATUS_S_OK = 0,
  ADS_STATUS_INVALID_SEARCHPREF,
  ADS_STATUS_INVALID_SEARCHPREFVALUE
} ADS_STATUSENUM;

상수


`ADS_STATUS_S_OK` 값: 0 검색 기본 설정이 성공적으로 설정되었습니다.
`ADS_STATUS_INVALID_SEARCHPREF` ADS_SEARCHPREF_INFO 구조체의 dwSearchPref 멤버에 지정된 검색 기본 설정이 잘못되었습니다. 검색 기본 설정은 ADS_SEARCHPREF_ENUM 열거형에서 가져와야 합니다.
`ADS_STATUS_INVALID_SEARCHPREFVALUE` ADS_SEARCHPREF_INFO 구조체의 vValue 멤버에 지정된 값이 해당 검색 기본 설정에 유효하지 않습니다.

설명

IDirectorySearch::SetSearchPreference 메서드는 dwStatus 멤버 ADS_SEARCHPREF_INFO 구조를 ADS_STATUSENUM 값 중 하나로 설정하여 해당 검색 기본 설정의 상태 나타냅니다. 호출자는 이 상태 값을 사용하여 검색을 실행할지 여부를 결정할 수 있습니다.

유효한 검색 기본 설정을 지정하면 ADS_STATUS_INVALID_SEARCHPREF 상태 값이 설정될 수 있지만 해당 기본 설정은 지원되지 않습니다. 예를 들어 ADS_SEARCHPREF_SORT_ON 설정했지만 통신하는 서버가 LDAP 서버 쪽 정렬 컨트롤을 지원하지 않는 경우 ADS_SEARCHPREF_INFO 구조체의 dwStatus 멤버는 IDirectorySearch::SetSearchPreference 호출에 의해 ADS_STATUS_INVALID_SEARCHPREF 설정됩니다.

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

예제

다음 코드 예제에서는 IDirectorySearch::SetSearchPreference 메서드와 함께 ADS_STATUSENUM 열거형을 사용하여 검색 기본 설정의 상태 확인하는 방법을 보여 줍니다.

/***************************************************************************

    SetAndCheckSearchTimeout()

***************************************************************************/

HRESULT SetAndCheckSearchTimeout(IDirectorySearch *pSearch, 
                                 DWORD dwTimeout, 
                                 ADS_STATUSENUM *pStatus)
{
    if(!pSearch || !pStatus)
    {
        return E_INVALIDARG;
    }
    
    HRESULT hr;
    ADS_SEARCHPREF_INFO SearchPref;

    SearchPref.dwSearchPref = ADS_SEARCHPREF_TIMEOUT;
    SearchPref.vValue.dwType = ADSTYPE_INTEGER;
    SearchPref.vValue.Integer = dwTimeout;
    SearchPref.dwStatus = ADS_STATUS_S_OK;

    hr = pSearch->SetSearchPreference(&SearchPref, 1);
    if(S_OK != hr)
    {
        return hr;
    }

    *pStatus = SearchPref.dwStatus;
    return S_OK;
}