SetConsoleCP 函式

設定與呼叫進程相關聯的主控台所使用的輸入代碼頁。 主控台會使用其輸入代碼頁,將鍵盤輸入轉譯為對應的字元值。

語法

BOOL WINAPI SetConsoleCP(
  _In_ UINT wCodePageID
);

參數

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

傳回值

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

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

備註

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

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

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage

不過,最好使用 EnumSystemCodePages 列舉代碼頁,因為登錄在不同的 Windows 版本中可能會有所不同。

若要判斷特定代碼頁是否有效,請使用 IsValidCodePage 函式。 若要擷取代碼頁的詳細資訊,包括其名稱,請使用 GetCPInfoEx 函式。 如需可用代碼頁識別碼的清單,請參閱 代碼頁識別碼

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

需求

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

另請參閱

主控台字碼頁

主控台函式

GetConsoleCP

GetConsoleOutputCP

SetConsoleOutputCP