共用方式為

__crtLCMapStringW

  • 發行項

將一個字元字串對應至另一個字元字串，並執行指定的地區設定相關轉換。 此函式也可用來產生輸入字串的排序鍵。

語法

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

參數

Locale
地區設定識別碼。 地區設定會提供用於字串對應或排序鍵產生的內容。 應用程式可以使用 MAKELCID 巨集來建立地區設定識別項。

dwMapFlags
字串對應或排序鍵產生期間所要使用的轉換類型。

lpSrcStr
函式對應或用於排序鍵產生的來源字串指標。 此參數會假設為 Unicode 字串。

cchSrc
lpSrcStr 參數所指向之字串的大小 (以字元為單位)。 此計數可選擇性地包含 Null 結束字元。

cchSrc 值 -1 指定 lpSrcStr 所指向的字串是以 null 終止的。 如果是，而且此函式正用於其字串對應模式，則函式會計算字串的長度本身，並以 null 結束儲存至 *lpDestStr 的對應字串。

lpDestStr
函式用來儲存對應字串或排序鍵之緩衝區的長指標。

cchDest
lpDestStr所指向之緩衝區的大小 (以字元為單位)。

傳回值

如果 cchDest 的值非零，寫入緩衝區的字元數或位元組 (指定 LCMAP_SORTKEY 時) 會表示成功。 此計數包含留給 Null 結束字元的空間。

如果 cchDest 的值為零，接收翻譯字串或排序鍵所需的緩衝區大小 (以字元為單位) 或位元組 (指定 LCMAP_SORTKEY 時) 會表示成功。 此大小包含留給 Null 結束字元的空間。

零表示失敗。 若要取得延伸錯誤資訊，請呼叫 GetLastError 函式。

備註

如果 cchSrc 大於零且 lpSrcStr 為以 null 終止的字串， __crtLCMapStringW 會將 cchSrc 設定為字串的長度。 然後 __crtLCMapStringW 會呼叫寬字串 (Unicode) 版本的 LCMapString 函式並指定其參數。 如需此函式參數和傳回值的詳細資訊，請參閱 LCMapString 。

需求

常式 必要的標頭
__crtLCMapStringW <awint.h>