共用方式為


SetConsoleOutputCP 函式

設定與呼叫進程相關聯的主控台所使用的輸出代碼頁。 主控台會使用其輸出代碼頁,將各種輸出函式所撰寫的字元值轉譯成主控台視窗中顯示的影像。

語法

BOOL WINAPI SetConsoleOutputCP(
  _In_ UINT wCodePageID
);

參數

wCodePageID [in]
要設定的代碼頁識別碼。 如需詳細資訊,請參閱<備註>。

傳回值

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

代碼頁會將 256 個字元代碼對應至個別字元。 不同的字碼頁包含不同的特殊字元,一般而言是針對語言或語言群組進行自訂。

如果目前的字型是固定的 Unicode 字型, SetConsoleOutputCP 會將字元值的對應變更為字型的字元集,而不是每次呼叫字元集時載入個別字型。 這會影響擴充字元 (ASCII 值大於127) 在主控台視窗中顯示的方式。 不過,如果目前的字型是點陣字型, SetConsoleOutputCP 不會影響延伸字元的顯示方式。

若要尋找作業系統所安裝或支援的代碼頁,請使用 EnumSystemCodePages 函 式。 本機電腦上可用的代碼頁識別碼也會儲存在登錄的下列機碼下:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage

不過,最好使用 EnumSystemCodePages 列舉代碼頁,因為登錄在不同的 Windows 版本中可能會有所不同。 若要判斷特定代碼頁是否有效,請使用 IsValidCodePage 函式。 若要擷取代碼頁的詳細資訊,包括其名稱,請使用 GetCPInfoEx 函式。 如需可用代碼頁識別碼的清單,請參閱 代碼頁識別碼

若要判斷主控台目前的輸出代碼頁,請使用 GetConsoleOutputCP 函式。 若要設定和擷取主控台的輸入代碼頁,請使用SetConsoleCP和 GetConsoleCP 函式。

需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
頁首 ConsoleApi2.h (透過 WinCon.h,包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

主控台字碼頁

主控台函式

GetConsoleCP

GetConsoleOutputCP

SetConsoleCP