DownlevelGetLocaleScripts 함수

지정된 로캘에 대한 스크립트 목록을 제공합니다.

참고 항목

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

 

구문

int DownlevelGetLocaleScripts(
  _In_  LPCWSTR lpLocaleName,
  _Out_ LPWSTR  lpScripts,
  _In_  int     cchScripts
);

매개 변수

lpLocaleName [in]

null로 끝나는 로캘 이름에 대한 포인터입니다.

lpScripts [out]

이 함수가 ISO 15924에서 사용되는 4자 표기법을 사용하여 스크립트 목록을 나타내는 null로 끝나는 문자열을 검색하는 버퍼에 대한 포인터입니다. 각 스크립트 이름은 4개의 라틴 문자로 구성되며 이름은 사전순으로 검색됩니다. 마지막을 포함하여 각각 세미콜론이 뒤따릅니다.

또는 cchScripts가 0으로 설정된 경우 이 매개 변수는 NULL을 포함할 수 있습니다. 이 경우 함수는 스크립트 버퍼에 필요한 크기를 반환합니다.

cchScripts [in]

lpScripts로 표시된 스크립트 버퍼의 크기( 문자)입니다.

또는 애플리케이션에서 이 매개 변수를 0으로 설정할 수 있습니다. 이 경우 함수는 lpScripts에서 NULL을 검색하고 스크립트 버퍼에 필요한 크기를 반환합니다.

반환 값

종료 null 문자를 포함하여 스크립트 버퍼에서 검색된 문자 수를 반환합니다. 함수가 성공하고 cchScripts 값이 0이면 반환 값은 스크립트 버퍼에 대해 종료 null 문자를 포함한 문자의 필수 크기입니다.

이 함수는 성공하지 못하면 0을 반환합니다. 확장 오류 정보를 가져오기 위해 애플리케이션은 다음 오류 코드 중 하나를 반환할 수 있는 GetLastError를 호출할 수 있습니다.

• ERROR_BADDB. 함수가 데이터에 액세스할 수 없습니다. 이 상황은 일반적으로 발생하지 않아야 하며 일반적으로 잘못된 설치, 디스크 문제 등을 나타냅니다.
• ERROR_INSUFFICIENT_BUFFER. 제공된 버퍼 크기가 충분히 크지 않거나 NULL로 잘못 설정되었습니다.
• ERROR_INVALID_PARAMETER. 매개 변수 값이 잘못되었습니다.

설명

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

다음은 충분한 버퍼 크기를 가정하여 이 함수에 대한 입력 및 출력의 몇 가지 예입니다.

로캘	lpLocaleName	lpScripts
영어(미국)	ko-KR	Latn;
힌디어(인도)	hi-IN	데바;
일본어(일본)	ja-JP	하니족; 히라; 가나;

 

로캘에 사용되는 쓰기 시스템의 필수 부분이 아니면 목록에 라틴어 스크립트가 포함되지 않습니다. 그러나 라틴 문자는 종종 외래 비즈니스 이름에 관해서는 네이티브가 아닌 로캘의 컨텍스트에서 사용됩니다. 위의 인도 힌디어 예제에서 검색된 유일한 스크립트는 "Deva"(Devanagari의 경우)이지만 라틴 문자는 힌디어 텍스트에도 나타날 수 있습니다. DownlevelVerifyScripts 함수에는 해당 사례를 해결하기 위한 특수 플래그가 있습니다.

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

요구 사항

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

참고 항목

국가별 언어 지원

국가별 언어 지원 함수

IDN(Internationalized Do기본 이름) 처리

DownlevelGetStringScripts

DownlevelVerifyScripts

GetLocaleInfo