__crtLCMapStringW

更新 : 2010 年 9 月

1 つの文字列を別の指定したロケールに依存変換を実行するマップします。 この関数を使用して、入力文字列の並べ替えキーを生成することもできます。

int __crtLCMapStringW(
   LCID    Locale,
   DWORD   dwMapFlags,
   LPCWSTR lpSrcStr,
   int     cchSrc,
   LPWSTR  lpDestStr,
   int     cchDest)

パラメーター

• Locale
  ロケール識別子。 ロケールは、文字列のマッピングまたは並べ替えキーの生成に、コンテキストを提供します。 アプリケーションを使用することができます、MAKELCIDは、ロケール識別子を作成するマクロ。

• dwMapFlags
  中に使用する文字列のマッピングまたは並べ替えキーの生成に使用する変換の種類。

• lpSrcStr
  関数は、マップまたは並べ替えキーの生成に使用するソース文字列へのポインター。 このパラメーターは、Unicode 文字列であると見なされます。

• cchSrc
  指す文字列の文字のサイズ、lpSrcStrパラメーター。 このカウントすることができます NULL ターミネータを含むまたは含まれていません。

  AcchSrc-1 の値は文字列で指すことlpSrcStrnull 終端です。 この場合に、この関数はその文字列のマッピング モードで使用されている場合は、関数は、文字列の長さ自体を計算しに格納されているマップされた文字列を null 終了*lpDestStr。

• lpDestStr
  Long 関数に割り当てられた文字列または並べ替えキーを格納するバッファーへのポインター。

• cchDest
  文字の指すバッファーのサイズlpDestStr。

戻り値

場合の値cchDest以外の文字またはバイトの数場合LCMAP_SORTKEY指定された、書き込みバッファーは成功します。 このカウントには、NULL 終端文字のための部屋が含まれています。

場合の値cchDest0、文字またはバイトのバッファーのサイズ場合はLCMAP_SORTKEY、翻訳を受信するために必要な指定された文字列または並べ替えキーは成功を示します。 このサイズには、NULL 終端文字のための部屋が含まれています。

0 は失敗を示します。 拡張エラー情報を取得するには、呼び出し、GetLastError機能。

解説

場合cchSrc0 より大きいとlpSrcStrnull で終わる文字列では、__crtLCMapStringWセットcchSrc、文字列の長さ。 __crtLCMapStringWのワイド文字列 (Unicode) バージョンを呼び出し、LCMapString指定されたパラメーターを持つ関数。 この関数の戻り値、パラメーターの詳細についてを参照してください、LCMapStringの機能MSDN Library。

必要条件

履歴の変更