FindNextCodePage
SNA 國家語言支援 (SNANLS) FindNextCodePage 函式會尋找符合 初始呼叫 FindFirstCodePage 函式中所指定條件的字碼頁下一個實例,並將字碼頁資訊複製到傳遞為參數的結構。
語法
BOOL WINAPI FindNextCodePage(
const HANDLE hInfo
struct CodePage *pPage
);
參數
hInfo
提供的 參數。 使用 FindFirstCodePage配置和傳回的控制碼。
pPage
提供和傳回的參數。 結構 CodePage 的指標,其中應該複製字碼頁資訊。
在成功傳回時,此參數所指向的記憶體位置會填入下一個字碼頁的資訊,滿足傳遞至FindFirstCodePage函式之dwEnumOption參數中的條件。
失敗時,不會對此參數所指向的記憶體進行任何變更。
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,則支援歐元符號。
傳回值
FindNextCodePage函式會在成功時傳回TRUE值。 失敗時,傳回的值為 FALSE。
備註
主機整合伺服器上的 SNANLS 支援此函式。