FindNLSString

識別子で指定されたロケールに対して、Unicode 文字列（ワイド文字）またはその等価物を別の Unicode 文字列内で検索する。注意: 非常に異なるバイナリ表現を持つ文字列が同一として比較される可能性があるため、この関数は特定のセキュリティ上の懸念を引き起こすことがある。詳細は Security Considerations:_International Features 内の比較関数の説明を参照。注: 相互運用性の観点から、Microsoft は新しいロケールにロケール識別子の代わりにロケール名を使用する方向に移行しているため、アプリケーションは FindNLSStringEx 関数を優先すべきである。FindNLSString はカスタムロケールをサポートするが、ほとんどのアプリケーションはこの種のサポートに FindNLSStringEx を使うべきである。

FindNLSString Locale, dwFindNLSStringFlags, lpStringSource, cchSource, lpStringValue, cchValue, pcchFound

Locale : [int] ロケールを指定するロケール識別子。MAKELCID マクロを使って識別子を作成するか、以下の定義済み値のいずれかを使用できる。
dwFindNLSStringFlags : [int] 検索操作の詳細を指定するフラグ。詳細な定義は FindNLSStringEx の dwFindNLSStringFlags パラメータを参照。
lpStringSource : [wstr] lpStringValue で指定された文字列を関数が検索する対象のソース文字列へのポインタ。
cchSource : [int] lpStringSource が指す文字列のサイズ（終端 NULL 文字を除く文字数）。アプリケーションはこのパラメータに 0 や -1 以外の負の数を指定できない。ソース文字列が NULL 終端で関数がサイズを自動計算すべき場合、アプリケーションは -1 を指定する。
lpStringValue : [wstr] 関数がソース文字列内で検索する検索文字列へのポインタ。
cchValue : [int] lpStringValue が指す文字列のサイズ（終端 NULL 文字を除く文字数）。アプリケーションはこのパラメータに 0 や -1 以外の負の数を指定できない。検索文字列が NULL 終端で関数がサイズを自動計算すべき場合、アプリケーションは -1 を指定する。
pcchFound : [var] 関数が見つけた文字列の長さを含むバッファへのポインタ。詳細は FindNLSStringEx の pcchFound パラメータを参照。

(プラグイン / モジュール : kernel32.dll)

解説

識別子で指定されたロケールに対して、Unicode 文字列（ワイド文字）またはその等価物を別の Unicode 文字列内で検索する。注意:
非常に異なるバイナリ表現を持つ文字列が同一として比較される可能性があるため、この関数は特定のセキュリティ上の懸念を引き起こすことがある。詳細は
Security Considerations:_International Features 内の比較関数の説明を参照。注:
相互運用性の観点から、Microsoft
は新しいロケールにロケール識別子の代わりにロケール名を使用する方向に移行しているため、アプリケーションは FindNLSStringEx
関数を優先すべきである。FindNLSString はカスタムロケールをサポートするが、ほとんどのアプリケーションはこの種のサポートに
FindNLSStringEx を使うべきである。

[戻り値]
成功した場合、lpStringSource が示すソース文字列内の 0 ベースのインデックスを返す。pcchFound
の値と組み合わせて、このインデックスはソース文字列内の見つかった文字列全体の正確な位置を提供する。戻り値 0
はソース文字列内のエラーフリーなインデックスであり、一致した文字列はソース文字列のオフセット 0 にある。関数が成功しなかった場合、-1
を返す。拡張エラー情報を取得するには、アプリケーションは GetLastError
を呼ぶことができ、次のいずれかのエラーコードを返すことがある。
（以下省略）

[備考]
FindNLSStringEx の Remarks を参照。

情報