NlsDllCodePageTranslation 関数 (gb18030.h)

  • [アーティクル]

フラグの設定に応じて、コード ページ情報を取得したり、変換を行ったりするために使用されます。

メモ この関数は使用しないでください。 Windows のバージョンによって動作が異なる場合があります。 GB18030 バイトを Unicode 文字または Unicode 文字から GB18030 バイトに変換するには、 MultiByteToWideChar 関数と WideCharToMultiByte 関数を使用します。
 

構文

DWORD NlsDllCodePageTranslation(
  [in]      DWORD    CodePage,
  [in]      DWORD    dwFlags,
  [in, out] LPSTR    lpMultiByteStr,
  [in]      int      cchMultiByte,
  [in, out] LPWSTR   lpWideCharStr,
  [in]      int      cchWideChar,
  [in]      LPCPINFO lpCPInfo
);

パラメーター

[in] CodePage

コード ページの値。 コード ページの値は 54936 にする必要があります。 それ以外の場合、関数はエラー コードを返します。

[in] dwFlags

翻訳を指定するフラグ。 使用できる値は、次の表で定義されています。

値 意味
NLS_CP_CPINFO
 lpCPInfo が指すバッファー内のコード ページ情報を取得します。 lpMultiByteStr、cchMultiByte、lpWideCharStr、および cchWideChar パラメーターは使用されません。
NLS_CP_MBTOWC
 GB18030 バイトを Unicode 文字に変換します。 ソース GB18030 文字は lpMultiByteStr で指す必要があり、 cchMultiByte にはバッファーのバイト数を含める必要があります。 Unicode の結果は lpWideCharStr が指すバッファーに格納され、 cchWideChar には Unicode バッファーの文字数が含まれている必要があります。 lpWideCharStr または cchWideChar が 0 の場合、Unicode 結果の予期される文字数が返され、変換は行われません。 この場合、 lpCPInfo パラメーターは使用されません。
NLS_CP_WCTOMB
 Unicode 文字を GB18030 バイトに変換します。 ソース Unicode 文字列は lpWideCharStr で指す必要があり、 cchWideChar にはバッファーの文字数を含める必要があります。 GB18030 の結果は lpMultiByteStr が指すバッファーに格納され、 cchMultiByte には GB18030 バッファーのバイト数が含まれている必要があります。 lpMultiByteStr または cchMultiByte が 0 の場合、GB18030 結果のバイト数が返され、変換は行われません。 この場合、 lpCPInfo パラメーターは使用されません。

[in, out] lpMultiByteStr

マルチバイト GB18030 文字を含むバッファーへのポインター。 dwFlags の値に応じて、ソース バッファーまたはターゲット バッファーを指定できます。

[in] cchMultiByte

マルチバイト バッファーのバイト数。

[in, out] lpWideCharStr

Unicode 文字を含むバッファーへのポインター。 dwFlags の値に応じて、ソース バッファーまたはターゲット バッファーを指定できます。

[in] cchWideChar

Unicode バッファーの文字数。

[in] lpCPInfo

CPINFO 構造体へのポインター。

戻り値

成功した場合は 1 を返します。 関数が成功しない場合は、0 を返します。 拡張エラー情報を取得するために、アプリケーションは GetLastError を呼び出すことができます。これにより、次のいずれかのエラー コードが返されます。

  • ERROR_INVALID_PARAMETER。 パラメーター値のいずれかが無効です。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー gb18030.h
[DLL] C_g18030.dll

関連項目

MultiByteToWideChar

WideCharToMultiByte