DsUnquoteRdnValueA 함수(dsparse.h)

아티클
08/23/2023

DsUnquoteRdnValue 함수는 따옴표 붙은 RDN 값을 따옴표가 없는 RDN 값으로 다시 변환하는 클라이언트 호출입니다. RDN은 원래 DN(고유 이름) 내에 포함되었을 때 잘못 해석될 수 있는 문자를 포함했기 때문에 따옴표가 없는 RDN 값을 LDAP와 같은 다양한 API를 사용하여 디렉터리 서비스에 DN의 일부로 제출해서는 안 됩니다.

통사론

DSPARSE DWORD DsUnquoteRdnValueA(
  [in]      DWORD cQuotedRdnValueLength,
  [in]      LPCCH psQuotedRdnValue,
  [in, out] DWORD *pcUnquotedRdnValueLength,
  [out]     LPCH  psUnquotedRdnValue
);

매개 변수

[in] cQuotedRdnValueLength

psQuotedRdnValue 문자열의 문자 수입니다.

[in] psQuotedRdnValue

따옴표로 묶고 이스케이프할 수 있는 RDN 값입니다.

[in, out] pcUnquotedRdnValueLength

이 인수의 입력 값은 psQuotedRdnValue최대 길이(문자)입니다.

이 인수의 출력 값에는 다음 플래그가 포함됩니다.

ERROR_SUCCESS

이는 문자 수가 psQuotedRdnValue사용된 문자열과 일치하는 경우 반환됩니다.

ERROR_BUFFER_OVERFLOW

이 값은 문자 수가 psQuotedRdnValue사용된 문자열과 일치하지 않는 경우 반환됩니다.

[out] psUnquotedRdnValue

변환된 따옴 지정되지 않은 RDN 값입니다.

반환 값

다음 목록에는 DsUnquoteRdnValue 함수에 대해 반환되는 가능한 값이 포함되어 있습니다.

발언

psQuotedRdnValue 따옴표가 붙은 경우:

선행 및 후행 따옴표가 제거됩니다.
첫 번째 따옴표 앞에 공백이 삭제됩니다.
마지막 따옴표 뒤에 있는 공백은 삭제됩니다.
이스케이프가 제거되고 이스케이프 다음 문자가 유지됩니다.

psQuotedRdnValue 따옴표가 지정되지 않은 경우 다음 작업이 수행됩니다.

선행 공백은 삭제됩니다.
후행 공백은 유지됩니다.
특수 문자가 아닌 이스케이프된 문자는 오류를 반환합니다.
이스케이프되지 않은 특수 문자는 오류를 반환합니다.
#(선행 공백 무시)으로 시작하는 RDN 값은 이전에 문자열로 변환되고 그에 따라 변환된 BER 값으로 처리됩니다.
이스케이프된 16진수(\89)는 이진 바이트(0x89)로 변환됩니다.
이스케이프된 특수 문자에서 이스케이프가 제거됩니다.

다음 작업은 항상 수행됩니다.

이스케이프된 특수 문자는 이스케이프되지 않습니다.
입력 및 출력 RDN 값은 null로 끝나는 값이 아닙니다.

메모

dsparse.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 DsUnquoteRdnValue를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	dsparse.h(Ntdsapi.h 포함)
라이브러리	Ntdsapi.lib
DLL	Ntdsapi.dll

참고 항목

도메인 컨트롤러 및 복제 관리 함수

DsQuoteRdnValue

다음을 통해 공유