Share via


IsNormalizedString 함수(winnls.h)

유니코드 4.0 TR#15에 따라 문자열이 정규화되었는지 확인합니다. 자세한 내용은 유니코드 정규화를 사용하여 문자열 표시를 참조하세요.

구문

BOOL IsNormalizedString(
  [in] NORM_FORM NormForm,
  [in] LPCWSTR   lpString,
  [in] int       cwLength
);

매개 변수

[in] NormForm

사용할 정규화 양식입니다. NORM_FORM 표준 유니코드 정규화 양식을 지정합니다.

[in] lpString

테스트할 문자열에 대한 포인터입니다.

[in] cwLength

null 종결 문자를 포함하여 입력 문자열의 길이(문자)입니다. 이 값이 -1이면 함수는 문자열을 null로 종료한다고 가정하고 길이를 자동으로 계산합니다.

반환 값

입력 문자열이 이미 적절한 형식으로 정규화된 경우 TRUE 를 반환하고, 그렇지 않으면 FALSE 를 반환합니다. 확장 오류 정보를 가져오기 위해 애플리케이션은 GetLastError를 호출할 수 있으며, 다음 오류 코드 중 하나를 반환할 수 있습니다.

  • ERROR_INVALID_PARAMETER. 매개 변수 값이 잘못되었습니다.
  • ERROR_NO_UNICODE_TRANSLATION. 잘못된 유니코드가 문자열에서 발견되었습니다.
  • ERROR_SUCCESS. 작업이 성공적으로 완료되었지만 결과가 생성되지 않았습니다.
오류 조건에서 FALSE 를 안정적으로 확인해야 하는 경우 SetLastError(ERROR_SUCCESS)를 호출해야 합니다.

설명

Windows XP, Windows Server 2003:

더 이상 지원되지 않습니다.

필수 헤더 파일 및 DLL은 더 이상 다운로드할 수 없는 Microsoft IDN(Internationalized Domain Name) 완화 API의 일부입니다.

예제

이 함수의 사용을 보여 주는 예제는 NLS: 유니코드 정규화 샘플에서 찾을 수 있습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 winnls.h(Windows.h 포함)
DLL Normaliz.dll
재배포 가능 파일 MICROSOFT IDN(Internationalized Domain Name) 완화 API onWindows XP with SP2 이상, 또는Windows Server 2003 with SP1

추가 정보

NORM_FORM

국가 언어 지원

국가 언어 지원 기능

NormalizeString

유니코드 정규화를 사용하여 문자열 표시