GetCodePage

SNA 國家語言支援 (SNANLS) GetCodePage 函式會將索引鍵所識別的字碼頁資訊複製到傳遞為參數的結構。

語法

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

參數

nKey
提供的 參數。 字碼頁的數值索引鍵。 這個值是陣列中的不透明索引，其中包含 SNANLS 所支援的字碼頁。 此值通常是從先前呼叫FindFirstCodePage 或 FindNextCodePage傳回之 CodePage 結構的CodePageKey成員。

pPage
提供和傳回的參數。 結構 CodePage 的指標，其中應該複製字碼頁資訊。

成功傳回時，此參數所指向的記憶體位置將會填入特定字碼頁的資訊。

失敗時，不會對此參數所指向的記憶體進行任何變更。

CodePage 結構定義于 SNANLS 中。H 包含檔案，如下所示：

struct CodePage {  
    BYTE    CodePageKey;  
    DWORD   CodePageID;  
    WCHAR   szFriendlyName[CP_SIZE];  
    short   eGroup;  
    BOOL    bAvailable;  
    BYTE    bccsid;  
    BOOL    bEuro;  
};  

此 CodePage 結構的成員如下所示：

CodePageKey

數值，表示 CodePage 結構的陣列中的索引。 此值應該用來作為不透明值，因為當支援其他字碼頁時，Service Pack 可以任意變更此值。

CodePageID

NLS 字碼頁碼。

szFriendlyName

此字碼頁的 SNANLS 顯示名稱。 字元字串為 null 終止。

eGroup

此字碼頁所代表的群組。 .此值可以是下列其中一個列舉，定義于 SNANLS.h 包含程式碼群組的檔案中：

ENUM_CP_EBCDIC

此字碼頁是 EBCDIC 字碼頁群組的成員。

ENUM_CP_ANSI

此字碼頁是 ANSI 字碼頁群組的成員。

ENUM_CP_ISO

此字碼頁是 ISO 字碼頁群組的成員。

ENUM_CP_OEMPC

此字碼頁是 OEM 電腦字碼頁群組的成員。

ENUM_CP_ISO

此字碼頁是 ISO 字碼頁群組的成員。

ENUM_CP_ISO

此字碼頁是 ISO 字碼頁群組的成員。

ENUM_CP_OEM電腦

此字碼頁是 OEM 電腦字碼頁群組的成員。

ENUM_CP_OPEN

此字碼頁是 Open Systems 字碼頁群組的成員。

ENUM_CP_UCS

此字碼頁是 UCS 字碼頁群組的成員。

bAvailable

布林值，用來指出電腦上已安裝此字碼頁。 這個成員的 FALSE 值表示不會查詢電腦，以判斷是否已安裝此字碼頁。 值為 TRUE ，表示已安裝字碼頁。

bccsid

用來指出字碼頁類型的旗標。 此旗標可以是下列其中一項：

ENUM_CP_DBCS (0x08)

字碼頁適用于雙位元組字元集。

ENUM_CP_MBCS (0x10)

字碼頁適用于混合位元組字元集。

ENUM_CP_SBCS (0x20)

字碼頁適用于單一位元組字元集。

bEuro

布林值，用來指出此字碼頁是否支援歐元符號。 如果此值為 TRUE，則支援歐元符號。

傳回值

GetCodePage函式會在成功時傳回TRUE值。 失敗時，傳回的值為 FALSE。

備註

主機整合伺服器上的 SNANLS 支援此函式。