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 |
| 헤더 |
|
| DLL |
|
참고 항목