FindNLSString 함수(winnls.h)

아티클
08/27/2023

식별자로 지정된 로캘의 다른 유니코드 문자열에서 유니코드 문자열(와이드 문자) 또는 해당 문자열을 찾습니다.

주의 이진 표현이 매우 다른 문자열은 동일하게 비교할 수 있으므로 이 함수는 특정 보안 문제를 제기할 수 있습니다. 자세한 내용은 보안 고려 사항: 국가별 기능에서 비교 함수에 대한 설명을 참조하세요.

참고 상호 운용성을 위해 Microsoft는 새 로캘에 대한 로캘 식별자 대신 로캘 이름을 사용하도록 마이그레이션하기 때문에 애플리케이션에서 FindNLSStringEx 함수를 선호해야 합니다. FindNLSString은 사용자 지정 로캘을 지원하지만 대부분의 애플리케이션은 이러한 유형의 지원에 FindNLSStringEx를 사용해야 합니다.

구문

int FindNLSString(
  [in]            LCID    Locale,
  [in]            DWORD   dwFindNLSStringFlags,
  [in]            LPCWSTR lpStringSource,
  [in]            int     cchSource,
  [in]            LPCWSTR lpStringValue,
  [in]            int     cchValue,
  [out, optional] LPINT   pcchFound
);

매개 변수

[in] Locale

로캘을 지정하는 로캘 식별자입니다. MAKELCID 매크로를 사용하여 식별자를 만들거나 다음 미리 정의된 값 중 하나를 사용할 수 있습니다.

Windows Vista 이상: 다음 사용자 지정 로캘 식별자도 지원됩니다.

[in] dwFindNLSStringFlags

찾기 작업의 세부 정보를 지정하는 플래그입니다. 자세한 정의는 FindNLSStringEx의 dwFindNLSStringFlags 매개 변수 를 참조하세요.

[in] lpStringSource

함수가 lpStringValue로 지정된 문자열을 검색하는 원본 문자열에 대한 포인터입니다.

[in] cchSource

lpStringSource로 표시된 문자열의 종료 null 문자를 제외한 문자의 크기입니다. 애플리케이션은 이 매개 변수에 대해 0 또는 -1 이외의 음수를 지정할 수 없습니다. 애플리케이션은 원본 문자열이 null로 종료되고 함수가 크기를 자동으로 계산해야 하는 경우 -1을 지정합니다.

[in] lpStringValue

함수가 원본 문자열에서 검색하는 검색 문자열에 대한 포인터입니다.

[in] cchValue

lpStringValue로 표시된 문자열의 종료 null 문자를 제외한 문자의 크기입니다. 애플리케이션은 이 매개 변수에 대해 0 또는 -1 이외의 음수를 지정할 수 없습니다. 애플리케이션은 검색 문자열이 null로 종료되고 함수가 크기를 자동으로 계산해야 하는 경우 -1을 지정합니다.

[out, optional] pcchFound

함수가 찾은 문자열의 길이를 포함하는 버퍼에 대한 포인터입니다. 자세한 내용은 FindNLSStringEx의 pcchFound 매개 변수를 참조하세요.

반환 값

성공하면 lpStringSource 가 나타내는 원본 문자열에 0 기반 인덱스 를 반환합니다. pcchFound의 값과 함께 이 인덱스 는 원본 문자열에 있는 전체 찾은 문자열의 정확한 위치를 제공합니다. 반환 값 0은 소스 문자열에 대한 오류 없는 인덱스이며 일치하는 문자열은 오프셋 0의 원본 문자열에 있습니다.

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

ERROR_INVALID_FLAGS. 플래그에 제공된 값이 잘못되었습니다.
ERROR_INVALID_PARAMETER. 매개 변수 값이 잘못되었습니다.
ERROR_SUCCESS. 작업이 성공적으로 완료되었지만 결과가 생성되지 않았습니다.

설명

FindNLSStringEx에 대한 설명을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winnls.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll