CompareStringOrdinal 함수(stringapiset.h)

아티클
08/26/2023

두 유니코드 문자열을 비교하여 이진 동등성을 테스트합니다.

구문

int CompareStringOrdinal(
  [in] _In_NLS_string_(cchCount1)LPCWCH lpString1,
  [in] int                              cchCount1,
  [in] _In_NLS_string_(cchCount2)LPCWCH lpString2,
  [in] int                              cchCount2,
  [in] BOOL                             bIgnoreCase
);

매개 변수

[in] lpString1

비교할 첫 번째 문자열에 대한 포인터입니다.

[in] cchCount1

lpString1로 표시된 문자열의 길이입니다. 문자열이 null로 종료된 경우 애플리케이션은 -1을 제공합니다. 이 경우 함수는 길이를 자동으로 결정합니다.

[in] lpString2

비교할 두 번째 문자열에 대한 포인터입니다.

[in] cchCount2

lpString2로 표시된 문자열의 길이입니다. 문자열이 null로 종료된 경우 애플리케이션은 -1을 제공합니다. 이 경우 함수는 길이를 자동으로 결정합니다.

[in] bIgnoreCase

TRUE 이면 운영 체제 대문자 테이블 정보를 사용하여 대/소문자를 구분하지 않는 비교를 수행합니다. 함수가 전달되는 문자열을 정확하게 비교하는 경우 애플리케이션은 이 매개 변수를 FALSE 로 설정합니다. 1은 잘못된 매개 변수 오류를 초래하지 않는 이 부울 매개 변수의 true 값을 지정하는 데 사용할 수 있는 유일한 숫자 값입니다. 이 매개 변수의 부울 값은 예상대로 작동합니다.

반환 값

성공하면 다음 값 중 하나를 반환합니다. 문자열 비교의 C 런타임 규칙을 유지하기 위해 0이 아닌 반환 값에서 값 2를 빼면 됩니다. 그런 다음, 0, ==0 및 >0의 <의미는 C 런타임과 일치합니다.

CSTR_LESS_THAN. lpString1로 표시된 값이 lpString2로 표시된 값보다 작습니다.
CSTR_EQUAL. lpString1로 표시된 값은 lpString2로 표시된 값과 같습니다.
CSTR_GREATER_THAN. lpString1로 표시된 값이 lpString2로 표시된 값보다 큽니다.

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

ERROR_INVALID_PARAMETER. 매개 변수 값이 잘못되었습니다.

설명

이 함수는 언어적 같음이 아닌 이진 같음을 테스트합니다. 서수 정렬에 함수를 사용하는 방법에 대한 자세한 내용은 애플리케이션에서 정렬 처리를 참조하세요.

언어 같음과 관련된 애플리케이션은 CompareString, CompareStringEx, lstrcmp 또는 lstrcmpi를 사용해야 합니다. 언어 정렬에 대한 자세한 내용은 애플리케이션에서 정렬 처리를 참조하세요.

Windows 8부터: CompareStringOrdinal 은 Stringapiset.h에서 선언됩니다. Windows 8 이전에는 Winnls.h에서 선언되었습니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	stringapiset.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll