CPINFO 結構 (winnls.h)

包含代碼頁的相關信息。 GetCPInfo 函式會使用此結構。

語法

typedef struct _cpinfo {
  UINT MaxCharSize;
  BYTE DefaultChar[MAX_DEFAULTCHAR];
  BYTE LeadByte[MAX_LEADBYTES];
} CPINFO, *LPCPINFO;

成員

MaxCharSize

代碼頁中字元的最大長度，以位元組為單位。 單一位元組字元集的長度可以是 1 (SBCS) 、2 表示雙位元組字元集 (DBCS) ，或針對其他字元集類型大於 2 的值。 函式無法使用大小來區別 SBCS 或 DBCS 與其他字元集，例如使用 ISCII 或 ISO-2022-xx 代碼頁。

DefaultChar[MAX_DEFAULTCHAR]

將字元字串轉譯為特定代碼頁時所使用的預設字元。 如果未指定明確的預設字元， WideCharToMultiByte 函式就會使用此字元。 默認值通常是代碼頁的 “？” 字元。

LeadByte[MAX_LEADBYTES]

前置位元組範圍的固定長度陣列，其前置位元組範圍的數目是可變的。 如果代碼頁沒有前置位元組，陣列的每個元素都會設定為 NULL。 如果代碼頁有前置位元組，陣列會指定每個範圍的起始值和結束值。 範圍包含，而任何代碼頁的範圍上限為五。 陣列會使用兩個字節來描述每個範圍，並將兩個 Null 位元組當做最後一個範圍之後的終止符。

注意 某些代碼頁使用前置位元組和其他編碼機制的組合。 此成員通常只會針對某些格式使用前置位元組的代碼頁子集填入。 如需詳細資訊，請參閱＜備註＞一節。

 

備註

前置位元組對於允許超過 256 個字元的 DBCS 代碼頁而言是唯一的。 前置位元組是 DBCS 中 2 位元組位元的第一個字節。 在每個 DBCS 代碼頁面上，前置位元組佔用特定的位元組值範圍。 此範圍對於不同的代碼頁不同。

前置位元組資訊對大部分的程式代碼頁並不有説明，甚至不會針對許多多位元組編碼提供，例如UTF-8和 GB18030。 不建議您的應用程式使用這項資訊來預測 MultiByteToWideChar 或 WideCharToMultiByte 函式的用途。 如果前置位元組後面的位元組未如預期般執行其他預設行為，函式最後可能會使用預設字元或執行其他預設行為。

GetCPInfoEx 函式所使用的 CPINFOEX 提供此結構的擴充版本。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	winnls.h (包含 Windows.h)

另請參閱

CPINFOEX

GetCPInfo

MultiByteToWideChar

國家語言支持結構

WideCharToMultiByte