GetCodePage

SNA 國家語言支援(SNANLS) GetCodePage 函式會將由鍵碼識別的代碼頁資訊複製到以參數形式傳遞的結構上。

語法

  
BOOL WINAPI GetCodePage(   
        Int nKey  
struct CodePage *pPage  
);  

參數

nKey
提供的參數。 代碼頁的數字鍵。 此值是一個不透明的索引,指向包含 SNANLS 支援的代碼頁陣列。 此值通常是 CodePage 結構中從先前呼叫 FindFirstCodePageFindNextCodePage 回傳的 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 支援。