OemToCharBuffA 関数 (winuser.h)

文字列内の指定した数の文字を OEM 定義文字セットから ANSI またはワイド文字文字列に変換します。

構文

BOOL OemToCharBuffA(
  [in]  LPCSTR lpszSrc,
  [out] LPSTR  lpszDst,
  [in]  DWORD  cchDstLength
);

パラメーター

[in] lpszSrc

型: LPCSTR を

OEM で定義された文字セットの 1 つ以上の文字。

[out] lpszDst

型: LPTSTR

変換された文字列を受け取る宛先バッファー。 OemToCharBuff 関数が ANSI 関数として使用されている場合は、lpszDst パラメーターを lpszSrc パラメーターと同じアドレスに設定することで、文字列を適切に変換できます。 これは、OemToCharBuff 関数がワイド文字関数として使用されている場合は実行できません。

[in] cchDstLength

型: DWORD

lpszSrc パラメーターによって識別されるバッファー内で変換される文字数。

戻り値

型: BOOL

戻り値は、同じアドレスを lpszSrc に渡し、ワイド文字バージョンの関数で lpszDst を する場合を除き、常に 0 以外です。 この場合、関数は 0 を返し、GetLastError は ERROR_INVALID_ADDRESSを返します。

備考

OemToChar 関数とは異なり、OemToCharBuff 関数は、lpszSrcが指すバッファーで null 文字が検出されたときに、文字の変換 停止しません。 OemToCharBuff 関数は、すべての cchDstLength 文字を変換します。

手記

winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして OemToCharBuff を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	winuser.h (Windows.h を含む)
ライブラリ	User32.lib
DLL	User32.dll
API セットの	ext-ms-win-ntuser-chartranslation-l1-1-0 (Windows 8 で導入)

関連項目

CharToOem を する

CharToOemBuff を する

概念

OemToChar

リファレンス

文字列の