DsQuoteRdnValueA 함수(dsparse.h)
DsQuoteRdnValue 함수는 RDN 값에 따옴표가 필요한 문자가 포함된 경우 RDN을 따옴표로 묶은 RDN 값으로 변환합니다. 그런 다음, 따옴표 붙은 RDN은 LDAP와 같은 다양한 API를 사용하여 DN(고유 이름)의 일부로 디렉터리 서비스에 제출할 수 있습니다. 따옴표가 필요한 RDN의 예는 "last,first" 형식을 사용하는 이름에 대한 RDN과 같이 쉼표로 구분된 값이 있는 것입니다.
통사론
DSPARSE DWORD DsQuoteRdnValueA(
[in] DWORD cUnquotedRdnValueLength,
[in] LPCCH psUnquotedRdnValue,
[in, out] DWORD *pcQuotedRdnValueLength,
[out] LPCH psQuotedRdnValue
);
매개 변수
[in] cUnquotedRdnValueLength
psUnquotedRdnValue 문자열의 문자 수입니다.
[in] psUnquotedRdnValue
따옴 표시되지 않은 RDN 값을 지정하는 문자열입니다.
[in, out] pcQuotedRdnValueLength
psQuotedRdnValue 문자열의 최대 문자 수입니다.
다음 플래그는 이 매개 변수의 출력입니다.
ERROR_SUCCESS
psQuotedRdnValue올바른 문자 수가 발견되었음을 나타냅니다.
ERROR_BUFFER_OVERFLOW
문자열의 문자 수가 psQuotedRdnValue
[out] psQuotedRdnValue
변환되고 따옴표로 묶인 RDN 값을 받는 문자열입니다.
반환 값
다음 목록에는 DsQuoteRdnValue 함수에 대해 반환되는 가능한 값이 포함되어 있습니다.
발언
필요한 항목이 없는 경우 따옴표가 RDN에 추가되지 않습니다. 이 경우 출력 RDN 값은 입력 RDN 값과 동일합니다.
따옴표가 필요한 경우 RDN은 "경량 디렉터리 액세스 프로토콜(v3): UTF-8 고유 이름의 문자열 표현" RFC 2253 사양에 따라 따옴표로 묶습니다.
입력 및 출력 RDN 값은 NULL종료된 문자열에
이 호출에서 변경한 내용을 되돌리려면 DsUnquoteRdnValue 함수를 호출합니다.
메모
dsparse.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 DsQuoteRdnValue를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | dsparse.h(Ntdsapi.h 포함) |
| 라이브러리 | Ntdsapi.lib |
| DLL | Ntdsapi.dll |