[CompareStringWrapW 는 Windows XP에서 사용할 수 있습니다. 후속 버전에서는 사용할 수 없습니다. 그 자리에 CompareStringW를 사용해야 합니다.]
지정된 로캘을 사용하여 두 개의 유니코드 문자열을 비교합니다.
참고
CompareStringWrapW 는 CompareStringW 함수에 대한 래퍼입니다. 추가 사용량 정보는 CompareString 페이지를 참조하세요.
구문
int CompareStringWrapW(
_In_ LCID Locale,
_In_ DWORD dwCmpFlags,
_In_ LPCWSTR lpString1,
_In_ int cchCount1,
_In_ LPCWSTR lpString2,
_In_ int cchCount2
);
매개 변수
-
로캘 [in]
-
형식: LCID
비교에 사용되는 로캘 식별자입니다. 이 매개 변수는 다음 미리 정의된 로캘 식별자 또는 MAKELCID 매크로에서 만든 로캘 식별자 중 하나일 수 있습니다.
-
LOCALE_SYSTEM_DEFAULT
-
시스템의 기본 로캘입니다.
-
LOCALE_USER_DEFAULT
-
현재 사용자의 기본 로캘입니다.
dwCmpFlags [in]
형식:DWORD
함수가 두 문자열을 비교하는 방법을 나타내는 플래그입니다. 기본적으로 이러한 플래그는 설정되지 않습니다. 기본 동작을 가져오기 위해 0으로 설정하거나 다음 값의 조합으로 설정합니다.
NORM_IGNORECASE
대/소문자를 무시합니다.
NORM_IGNOREKANATYPE
히라가나와 가타카나 문자를 구분하지 마세요. 해당 히라가나와 가타카나 문자는 동일하게 비교합니다.
NORM_IGNORENONSPACE
간격이 없는 문자를 무시합니다.
NORM_IGNORESYMBOLS
기호를 무시합니다.
NORM_IGNOREWIDTH
싱글 바이트 문자와 더블 바이트 문자와 동일한 문자를 구분하지 마세요.
SORT_STRINGSORT
문장 부호를 기호와 동일하게 처리합니다.
lpString1 [in]
형식: LPCWSTR
비교할 첫 번째 유니코드 문자열에 대한 포인터입니다.
cchCount1 [in]
형식: int
lpString1 매개 변수가 가리키는 문자열의 문자 수입니다. 개수에는 종료 null 문자가 포함되지 않습니다. 이 매개 변수가 음수 값이면 문자열은 null로 끝나는 것으로 간주되고 길이는 자동으로 계산됩니다.
lpString2 [in]
형식: LPCWSTR
비교할 두 번째 유니코드 문자열에 대한 포인터입니다.
cchCount2 [in]
형식: int
lpString2 매개 변수가 가리키는 문자열의 문자 수입니다. 개수에는 종료 null 문자가 포함되지 않습니다. 이 매개 변수가 음수 값이면 문자열은 null로 끝나는 것으로 간주되고 길이는 자동으로 계산됩니다.
반환 값
형식: int
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. GetLastError 는 다음 오류 코드 중 하나를 반환할 수 있습니다.
- ERROR_INVALID_FLAGS
- ERROR_INVALID_PARAMETER
함수가 성공하면 반환 값은 다음 값 중 하나입니다.
| 요구 사항 | 값 |
|---|---|
| CSTR_LESS_THAN | lpString1 매개 변수가 가리키는 문자열은 lpString2 매개 변수가 가리키는 문자열보다 어휘 값이 적습니다. |
| CSTR_EQUAL | lpString1이 가리키는 문자열은 lpString2가 가리키는 문자열과 어휘 값이 같습니다. |
| CSTR_GREATER_THAN | lpString1이 가리키는 문자열이 lpString2에서 가리키는 문자열보다 어휘 값이 더 큽니다. |
설명
보안 경고: 이 함수를 잘못 사용하면 애플리케이션의 보안이 손상됩니다. 올바르게 비교되지 않은 문자열은 잘못된 입력을 생성할 수 있습니다. 문자열을 테스트하여 문자열을 사용하기 전에 유효한지 확인하고 오류 처리기를 제공합니다. 자세한 내용은 보안 고려 사항: 국가별 기능을 참조하세요.
기본 방법은 MsLU(Microsoft Layer for Unicode)와 함께 CompareStringW 를 사용하는 것입니다.
CompareStringWrapW 는 서수 45를 사용하여 Shlwapi.dll 직접 호출해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 헤더 |
|
| DLL |
|
추가 정보