SNA 國家語言支援(SNANLS) GetCodePage 函式會將由鍵碼識別的代碼頁資訊複製到以參數形式傳遞的結構上。
語法
BOOL WINAPI GetCodePage(
Int nKey
struct CodePage *pPage
);
參數
nKey
提供的參數。 代碼頁的數字鍵。 此值是一個不透明的索引,指向包含 SNANLS 支援的代碼頁陣列。 此值通常是 CodePage 結構中從先前呼叫 FindFirstCodePage 或 FindNextCodePage 回傳的 CodePageKey 成員。
pPage
提供與回傳參數。 一個指向結構 CodePage 的指標,應該複製代碼頁資訊。
成功回傳後,該參數指向的記憶體位置將被填入該特定代碼頁的資訊。
當故障時,該參數指向的記憶體不會再做任何變更。
CodePage 結構在 SNANLS 中定義。包含檔案如下:
struct CodePage {
BYTE CodePageKey;
DWORD CodePageID;
WCHAR szFriendlyName[CP_SIZE];
short eGroup;
BOOL bAvailable;
BYTE bccsid;
BOOL bEuro;
};
此代碼頁結構的成員如下:
代碼頁面鍵
一個數值,代表代碼頁結構陣列中的索引。 此值應作為不透明值使用,因為當支援額外程式碼頁時,服務包可任意更改此值。
CodePageID
NLS 代碼頁碼。
szFriendly Name
SNANLS 顯示此代碼頁的名稱。 字串為空終止。
eGroup
這個代碼頁所代表的群組。 .此值可為 SNANLS.h 包含檔案中定義的以下列舉之一:
ENUM_CP_EBCDIC
此代碼頁是 EBCDIC 代碼頁群組的成員。
ENUM_CP_ANSI
此代碼頁是 ANSI 代碼頁群組的成員。
ENUM_CP_ISO
此代碼頁是 ISO 代碼頁群組的成員。
ENUM_CP_OEMPC
此代碼頁是 OEM PC 代碼頁組的成員。
ENUM_CP_ISO
此代碼頁是 ISO 代碼頁群組的成員。
ENUM_CP_ISO
此代碼頁是 ISO 代碼頁群組的成員。
ENUM_CP_OEM PC
此代碼頁是 OEM PC 代碼頁組的成員。
ENUM_CP_OPEN
此代碼頁是開放系統代碼頁小組的成員。
ENUM_CP_UCS
此代碼頁是 UCS 代碼頁群組的成員。
b可用
使用布林值表示此代碼頁已安裝於電腦上。 此成員的 FALSE 值表示電腦不會被查詢是否安裝了此代碼頁。 TRUE 值表示代碼頁已安裝。
BCCSID
一個用來指示代碼頁類型的旗標。 此旗幟可為以下之一:
ENUM_CP_DBCS(0x08)
該代碼頁是用於雙位元組字元集。
ENUM_CP_MBCS(0x10)
程式碼頁是為混合位元組字元集設計的。
ENUM_CP_SBCS(0x20)
程式碼頁是針對單位元組字元集的。
歐洲
一個布林值用來表示此代碼頁是否支援歐元符號。 如果這個數值為 真,則支持歐元符號。
傳回值
GetCodePage 函式在成功時回傳 TRUE 值。 失敗時,回傳的值為 FALSE。
備註
此功能由主機整合伺服器上的 SNANLS 支援。