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 |