다음을 통해 공유


ADS_ESCAPE_MODE_ENUM 열거형(iads.h)

ADS_ESCAPE_MODE_ENUM 열거형은 이스케이프 문자가 디렉터리 경로에 표시되는 방법을 지정합니다.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0001_0078_0004 {
  ADS_ESCAPEDMODE_DEFAULT = 1,
  ADS_ESCAPEDMODE_ON = 2,
  ADS_ESCAPEDMODE_OFF = 3,
  ADS_ESCAPEDMODE_OFF_EX = 4
} ADS_ESCAPE_MODE_ENUM;

상수

 
ADS_ESCAPEDMODE_DEFAULT
값: 1
기본 이스케이프 모드는 이스케이프 모드를 지정하는 편리한 옵션을 제공합니다. 선택한 형식에 적합한 최소 이스케이프 작업의 효과가 있습니다. 따라서 기본 동작은 ADS_FORMAT_ENUM 디렉터리 경로를 검색하는 데 사용하는 값에 따라 달라집니다.










































검색된 경로 형식기본 이스케이프 모드
ADS_FORMAT_X500ADS_ESCAPEDMODE_ON
ADS_FORMAT_X500_NO_SERVERADS_ESCAPEDMODE_ON
ADS_FORMAT_WINDOWSADS_ESCAPEDMODE_ON
ADS_FORMAT_WINDOWS_NO_SERVERADS_ESCAPEDMODE_ON
ADS_FORMAT_X500_DNADS_ESCAPEDMODE_OFF
ADS_FORMAT_X500_PARENTADS_ESCAPEDMODE_OFF
ADS_FORMAT_WINDOWS_DNADS_ESCAPEDMODE_OFF
ADS_FORMAT_WINDOWS_PARENTADS_ESCAPEDMODE_OFF
ADS_FORMAT_LEAFADS_ESCAPEDMODE_ON
ADS_ESCAPEDMODE_ON
값: 2
모든 특수 문자는 이스케이프 형식으로 표시됩니다. 예를 들어 "CN=date=yy/mm/dd,weekday"가 있는 그대로 표시됩니다.
ADS_ESCAPEDMODE_OFF
값: 3
ADSI 특수 문자는 이스케이프되지 않은 형식으로 표시됩니다. 예를 들어 "CN=date=yy/mm/dd,weekday"는 "CN=date=yy/mm/dd,weekday"로 표시됩니다.
ADS_ESCAPEDMODE_OFF_EX
값: 4
ADSI 및 LDAP 특수 문자는 이스케이프되지 않은 형식으로 표시됩니다. 예를 들어 "CN=date=yy/mm/dd,weekday"는 "CN=date=yy/mm/dd,weekday"로 표시됩니다.

설명

의도하지 않은 용도로 사용할 경우 특수 문자를 이스케이프해야 합니다. 예를 들어 LDAP 특수 문자, 쉼표(,) 및 등호(=)는 "CN=user,CN=users,DC=Fabrikam,DC=com"이라는 고유 이름의 필드 구분 기호로 사용됩니다. 특성 값이 "CN=users,last name=Smith"와 같은 특수 문자를 사용하는 경우 이러한 특수 문자는 표시된 대로 이스케이프되어야 합니다. 이렇게 하면 Active Directory와 같은 LDAP 규격 디렉터리가 경로를 제대로 구문 분석합니다. 그러나 이스케이프된 경로 문자열은 디스플레이에서 사용자에게 친숙한 것으로 보이지 않을 수 있습니다. 이 경우 경로를 이스케이프되지 않은 문자열 "CN=users,last name=Smith"로 표시하는 방식으로 ADS_ESCAPE_MODE_ENUM 설정할 수 있습니다.

마찬가지로 ADSI 특수 문자 슬래시 표시(/)는 ADSI 관련 요소인 "LDAP://server/CN=Jeff Smith,CN=Users,DC=Fabrikam,DC=com"을 구분합니다. "LDAP://server/CN=Jeff Smith/California,CN=Users,DC=Fabrikam,DC=com"와 같은 다른 용도로 사용할 때는 이스케이프해야 합니다. 이 이스케이프된 문자열을 사람이 읽을 수 있는 형식으로 표시하는 ADS_ESCAPE_MODE_ENUM 옵션을 선택할 수 있습니다. "LDAP://server/CN=Jeff Smith/California,CN=Users,DC=Fabrikam,DC=com".

현재 슬래시 표시(/)가 유일한 ADSI 특수 문자입니다. ADSI 이스케이프 및 이스케이프 해제는 ADSI 특수 문자에만 적용됩니다. 이 작업은 LDAP 특수 문자에 영향을 주지 않습니다. 즉, 이스케이프되거나 이스케이프되지 않습니다. 자세한 내용과 LDAP에서 정의한 특수 문자 목록은 LDAP 특수 문자를 참조하세요.

이스케이프되지 않은 경로 문자열을 표시하려면 IADsPathname 인터페이스 및 해당 메서드를 사용합니다. 다른 모든 ADSI API는 이스케이프된 경로 문자열을 반환합니다.

올바른 동작을 얻으려면 ADSI 특수 문자를 이스케이프하기 전에 LDAP 특수 문자를 이스케이프해야 합니다. IADsPathname 인터페이스는 올바른 시퀀스의 문자를 이스케이프합니다.

참고 VBScript는 형식 라이브러리에서 데이터를 읽을 수 없으므로 VBScript(Visual Basic Scripting Edition) 애플리케이션은 위에서 정의한 상수로 기호를 인식하지 못합니다. 대신 숫자 상수를 사용하여 VBScript 애플리케이션에서 적절한 플래그를 설정합니다. 기호 상수를 사용하려면 여기에서와 같이 이러한 상수의 명시적 선언을 작성합니다.
 

요구 사항

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

추가 정보

ADSI 열거형

ADS_FORMAT_ENUM

IADsPathname

LDAP ADsPath