CharToOemA 函式 (winuser.h)

將字串轉譯成 OEM 定義的字元集。

警告 請勿使用。 請參閱安全性考慮。
 

語法

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

參數

[in] pSrc

類型: LPCTSTR

要轉譯的 Null 終止字串。

[out] pDst

類型: LPSTR

接收翻譯字串的目的地緩衝區。 如果將 CharToOem 函式當做 ANSI 函式使用,可以將 lpszDst 參數設定為 與 lpszSrc 參數相同的位址,以就地轉譯字串。 如果 CharToOem 做為寬字元函式,則無法完成此作業。

傳回值

類型: BOOL

傳回值一律為非零值,除非您在函式寬字元版本中將相同的位址傳遞至 lpszSrclpszDst 。 在此情況下,函式會傳回零, 而 GetLastError 會傳回 ERROR_INVALID_ADDRESS

備註

注意

winuser.h 標頭會將 CharToOem 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-chartranslation-l1-1-0 (於 Windows 8)

另請參閱

CharToOemBuff

概念

OemToChar

OemToCharBuff

參考

字串