다음을 통해 공유


DownlevelVerifyScripts 함수

두 개의 열거형 스크립트 목록을 비교합니다.

참고 항목

이 함수는 Windows Vista 이전 운영 체제에서 실행되는 애플리케이션에서만 사용됩니다. 사용하려면 다운로드 패키지가 필요합니다. Windows Vista 이상에서만 실행되는 애플리케이션은 VerifyScripts를 호출해야 합니다.

 

구문

BOOL DownlevelVerifyScripts(
  _In_ DWORD   dwFlags,
  _In_ LPCWSTR lpLocaleScripts,
  _In_ int     cchLocaleScripts,
  _In_ LPCWSTR lpTestScripts,
  _In_ int     cchTestScripts
);

매개 변수

dwFlags [in]

스크립트 확인 옵션을 지정하는 플래그입니다.

의미
VS_ALLOW_LATIN
로캘 목록에 없는 경우에도 테스트 목록에서 "Latn"(라틴어 스크립트)을 허용합니다.

 

lpLocaleScripts [in]

지정된 로캘에 대해 열거된 스크립트 목록인 로캘 목록에 대한 포인터입니다. 이 목록은 일반적으로 DownlevelGetLocaleScripts를 호출 하여 채워집니다.

cchLocaleScripts [in]

lpLocaleScripts로 표시된 문자열의 크기(문자)입니다. 문자열이 null로 종료된 경우 애플리케이션은 이 매개 변수를 -1로 설정합니다. 이 매개 변수를 0으로 설정하면 함수가 실패합니다.

lpTestScripts [in]

두 번째 열거형 스크립트 목록인 테스트 목록에 대한 포인터입니다. 이 목록은 일반적으로 DownlevelGetStringScripts를 호출 하여 채워집니다.

cchTestScripts [in]

lpTestScripts로 표시된 문자열의 크기(문자)입니다. 문자열이 null로 종료된 경우 애플리케이션은 이 매개 변수를 -1로 설정합니다. 이 매개 변수를 0으로 설정하면 함수가 실패합니다.

반환 값

테스트 목록이 비어 있고 목록의 모든 항목도 로캘 목록에 포함되면 TRUE를 반환합니다. 그렇지 않으면 함수는 FALSE를 반환합니다.

FALSE반환 값은 테스트 목록에 로캘 목록에 없는 항목이 포함되어 있거나 오류를 나타낼 수 있음을 나타낼 수 있습니다. 이러한 두 경우를 구분하기 위해 애플리케이션은 GetLastError를 호출할 수 있습니다. DownlevelVerifyScripts가 테스트 목록에 로캘 목록에 없는 항목이 있는지 확인하면 GetLastError는 ERROR_SUCCESS 반환합니다. 그렇지 않으면 GetLastError 는 다음 오류 코드 중 하나를 반환할 수 있습니다.

  • ERROR_INVALID_FLAGS. 플래그에 제공된 값이 잘못되었습니다.
  • ERROR_INVALID_PARAMETER. 매개 변수 값이 잘못되었습니다.

설명

이 함수는 "Latn; 같은 문자열을 비교합니다. Cyrl;"은 각 스크립트 이름 뒤에 세미콜론이 있는 일련의 4자 스크립트 이름으로 구성됩니다. 또한 라틴어 스크립트가 네이티브가 아닌 언어 및 로캘에서 자주 사용된다는 사실을 고려하는 특별한 경우도 있습니다.

이 함수는 IDN(국제화된 do기본 이름)과 관련된 보안 문제를 완화하기 위한 전략의 일부로 유용합니다.

다음은 이 함수의 반환 및 다양한 시나리오에서 GetLastError에 대한 후속 호출의 예입니다. 마지막 두 예제에서는 각각 테스트 목록에 종료 세미콜론(잘못된 형식의 문자열)이 없는 경우와 테스트 목록이 비어 있는 경우를 보여 줍니다.

"로캘" 문자열 "Test" 문자열 dwFlags 반환 값 GetLastError 반환
하니족; 히라; 가나; 하니족; 해당 없음 TRUE 해당 없음
하니족; 히라; 가나; 하니족; Latn; 0 FALSE ERROR_SUCCESS
하니족; 히라; 가나; 하니족; Latn; VS_ALLOW_LATIN TRUE 해당 없음
하니족; 히라; 가나; Cyrl; 해당 없음 FALSE ERROR_SUCCESS
하니족; 히라; 가나; Cyrl; 해당 없음 FALSE ERROR_INVALID_PARAMETER
하니족; 히라; 가나; 해당 없음 FALSE ERROR_SUCCESS

 

필요한 헤더 파일 및 DLL은 archive.org 사용할 수 있는 "IdN(Microsoft Internationalized Do기본 Name) 완화 API" 다운로드의 일부입니다.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버
Windows Server 2003 [데스크톱 앱만 해당]
재배포 가능 파일
MICROSOFT IDN(Internationalized Do기본 Name) 완화 API onWindows XP SP2, WINDOWS Server 2003 sp1 또는Windows Vista
헤더
Idndl.h
DLL
Idndl.dll

참고 항목

국가별 언어 지원

국가별 언어 지원 함수

IDN(Internationalized Do기본 이름) 처리

DownlevelGetLocaleScripts

DownlevelGetStringScripts

VerifyScripts