共用方式為

__crtLCMapStringW

  • 發行項

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

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

參數

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

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

  • lpSrcStr
    函式會將對應，或用於排序的金鑰產生的來源字串的指標。這個參數被假設為 Unicode 字串。

  • cchSrc
    以字元為單位所指的字串的大小， lpSrcStr參數。這個計數可以包含 NULL 結束字元，或包含它。

    A 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**在MSDN Library。

需求

常式

所需的標頭

__crtLCMapStringW

awint.h