CharToOemA 関数 (winuser.h)

[アーティクル]
08/08/2024

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

警告は使用しないでください。「セキュリティに関する考慮事項」を参照してください。

構文

BOOL CharToOemA(
  [in]  LPCSTR pSrc,
  [out] LPSTR  pDst
);

パラメーター

[in] pSrc

種類: LPCTSTR

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

[out] pDst

種類: LPSTR

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

戻り値

種類: BOOL

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

注釈

注意

winuser.h ヘッダーは、CharToOem をエイリアスとして定義し、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で導入)