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