CharToOemBuffA 関数 (winuser.h)

文字列内の指定した数の文字を OEM 定義の文字セットに変換します。

構文

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

パラメーター

[in] lpszSrc

種類: LPCTSTR

変換する null で終わる文字列。

[out] lpszDst

種類: LPSTR

変換された文字列のバッファー。 CharToOemBuff 関数が ANSI 関数として使用されている場合は、lpszDst パラメーターを lpszSrc パラメーターと同じアドレスに設定することで、文字列をインプレースで変換できます。 CharToOemBuff がワイド文字関数として使用されている場合、これを行うことはできません。

[in] cchDstLength

型: DWORD

lpszSrc パラメーターで識別される文字列内で変換する文字数。

戻り値

種類: BOOL

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

注釈

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

注意

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

要件

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

こちらもご覧ください

CharToOem

概念

OemToChar

OemToCharBuff

リファレンス

文字列