FindNLSString 함수(winnls.h)
식별자로 지정된 로캘의 다른 유니코드 문자열에서 유니코드 문자열(와이드 문자) 또는 해당 문자열을 찾습니다.
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 |