次の方法で共有

__crtLCMapStringW

  • [アーティクル]

マップ別の種類の 1 文字列指定されたロケール依存の変換を行います。この関数が入力文字列の並べ替えキーの生成に使用できます。

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

パラメーター

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

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

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

  • cchSrc
    lpSrcStr のパラメーターが指す文字列の文字単位のサイズを調整します。この数値はnull 終端文字が含まれているまたは含めることができます。

    cchSrc の値である lpSrcStr が指す文字列が null で終わることを 1 行に指定します。この場合この関数が文字列マップ モードで使用すると関数は文字列自体の長さを計算し*lpDestStr に格納されているマップされた文字列が null で終了します。

  • lpDestStr
    関数がマップされた文字列や並べ替えキーを格納するバッファーへのポインター。long

  • cchDest
    lpDestStrが指すバッファーの文字単位のサイズを調整します。

戻り値

cchDest の値がゼロ以外の場合はLCMAP_SORTKEY が指定されている文字のバッファーに書き込むバイト数つまりは成功を示します。この数値には終端文字 NULL 用の領域が含まれます。

cchDest の値がゼロの場合LCMAP_SORTKEY が指定されている文字のバッファーの変換された文字列や並べ替えキーを受信するために必要なサイズ (バイトは成功を示します。このサイズは終端文字 NULL 用の領域が含まれます。

ゼロは失敗を示します。エラー情報を拡張するにはGetLastError の関数を呼び出します。

解説

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

必要条件

ルーチン

必須ヘッダー

__crtLCMapStringW

awint.h