CharToOemBuffW

文字列内の指定数の文字を OEM 定義の文字セットに変換する。(Unicode)

CharToOemBuffW lpszSrc, lpszDst, cchDstLength

lpszSrc : [wstr] 型: LPCTSTR 変換する null 終端文字列。
lpszDst : [str] 型: LPSTR 変換後の文字列を格納するバッファ。CharToOemBuff 関数を ANSI 関数として使用する場合、lpszDst を lpszSrc と同じアドレスに設定することで文字列をその場で変換できる。CharToOemBuff をワイド文字関数として使用する場合はこれを行えない。
cchDstLength : [int] 型: DWORD lpszSrc パラメータで指定された文字列内で変換する文字数。

(プラグイン / モジュール : user32.dll)

解説

文字列内の指定数の文字を OEM 定義の文字セットに変換する。(Unicode)

[戻り値]
型: BOOL 戻り値は常に 0 以外。ただしワイド文字版の関数で lpszSrc と lpszDst
に同じアドレスを渡した場合は例外で、その場合は 0 を返し GetLastError は ERROR_INVALID_ADDRESS
を返す。

[備考]
CharToOem 関数とは異なり、CharToOemBuff 関数は lpszSrc が指すバッファ内で null
文字に遭遇しても文字変換を停止しない。CharToOemBuff 関数は cchDstLength 文字すべてを変換する。
> [!NOTE] > winuser.h ヘッダは CharToOemBuff をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づき自動的に ANSI/Unicode
版を選択する。エンコーディング非依存のエイリアスとそうでないコードを混在させると、コンパイル時または実行時のエラーにつながる不一致が生じる可能性がある。詳細は
Conventions for Function Prototypes を参照。

情報