__crtLCMapStringW__crtLCMapStringW

지정된 로캘 종속 변환을 수행하여 하나의 문자열을 다른 문자열에 매핑합니다.Maps one character string to another, performing a specified locale-dependent transformation. 이 함수는 입력 문자열에 대한 정렬 키를 생성하는 데에도 사용될 수 있습니다.This function can also be used to generate a sort key for the input string.

구문Syntax

int __crtLCMapStringW(  
   LCID    Locale,  
   DWORD   dwMapFlags,  
   LPCWSTR lpSrcStr,  
   int     cchSrc,  
   LPWSTR  lpDestStr,  
   int     cchDest)  

매개 변수Parameters

Locale
로캘 식별자입니다.Locale identifier. 로캘은 문자열 매핑 또는 정렬 키 생성을 위한 컨텍스트를 제공합니다.The locale provides a context for the string mapping or sort key generation. 응용 프로그램은 MAKELCID 매크로를 사용하여 로캘 식별자를 만들 수 있습니다.An application can use the MAKELCID macro to create a locale identifier.

dwMapFlags
문자열 매핑 또는 정렬 키 생성 시 사용할 변환 형식입니다.The type of transformation to be used during string mapping or sort key generation.

lpSrcStr
함수가 정렬 키 생성을 위해 매핑하거나 사용하는 소스 문자열에 대한 포인터입니다.Pointer to a source string that the function maps or uses for sort key generation. 이 매개 변수는 유니코드 문자열로 간주됩니다.This parameter is assumed to be a Unicode string.

cchSrc
lpSrcStr 매개 변수가 가리키는 문자열의 크기(문자)입니다.Size, in characters, of the string pointed to by the lpSrcStr parameter. 이 수는 NULL 종결자를 포함하거나 포함하지 않을 수 있습니다.This count can include the NULL terminator, or not include it.

cchSrc 값이 -1이면 lpSrcStr이 가리키는 문자열이 null로 끝나도록 지정됩니다.A cchSrc value of -1 specifies that the string pointed to by lpSrcStr is null-terminated. 이 경우 이 함수가 해당 문자열 매핑 모드에서 사용 중이면 해당 함수는 문자열 길이 자체를 계산하고 *lpDestStr에 저장된 매핑된 문자열을 null로 끝냅니다.If this is the case, and this function is being used in its string-mapping mode, the function calculates the string's length itself, and null-terminates the mapped string stored into *lpDestStr.

lpDestStr
함수가 매핑된 문자열 또는 정렬 키를 저장하는 버퍼에 대한 긴 포인터입니다.Long pointer to a buffer into which the function stores the mapped string or sort key.

cchDest
lpDestStr이 가리키는 버퍼의 크기(문자)입니다.Size, in characters, of the buffer pointed to by lpDestStr.

반환 값Return Value

cchDest 의 값이 0이 아닌 경우 문자 수 또는 바이트이며, LCMAP_SORTKEY 가 지정된 경우 버퍼에 쓰여진 값은 성공을 나타냅니다.If the value of cchDest is nonzero, the number of characters, or bytes if LCMAP_SORTKEY is specified, written to the buffer indicates success. 이 수는 NULL 종결자에 대한 공간을 포함합니다.This count includes room for a NULL terminator.

cchDest 의 값이 0인 경우 버퍼의 크기(문자 또는 바이트)이며, LCMAP_SORTKEY 가 지정된 경우 변환된 문자열 또는 정렬 키를 받는 데 필요한 값은 성공을 나타냅니다.If the value of cchDest is zero, the size of the buffer in characters, or bytes if LCMAP_SORTKEY is specified, required to receive the translated string or sort key indicates success. 이 크기는 NULL 종결자에 대한 공간을 포함합니다.This size includes room for a NULL terminator.

0은 실패를 나타냅니다.Zero indicates failure. 확장 오류 정보를 가져오려면 GetLastError 함수를 호출하십시오.To get extended error information, call the GetLastError function.

설명Remarks

cchSrc 가 0보다 크고 lpSrcStr 이 null 종결 문자열인 경우 __crtLCMapStringWcchSrc 를 문자열 길이로 설정합니다.If cchSrc is greater than zero and lpSrcStr is a null-terminated string, __crtLCMapStringW sets cchSrc to the length of the string. 그러면 __crtLCMapStringW 가 지정된 매개 변수를 사용하여 LCMapString 함수의 와이드 문자(유니코드) 버전을 호출합니다.Then __crtLCMapStringW calls the wide string (Unicode) version of the LCMapString function with the specified parameters. 이 함수의 반환 값 및 매개 변수에 대한 자세한 내용은 LCMapString MSDN 라이브러리 에서함수를 참조하세요.For more information about the parameters and return value of this function, see the LCMapString function at MSDN Library.

요구 사항Requirements

루틴Routine 필수 헤더Required header
__crtLCMapStringW__crtLCMapStringW awint.hawint.h