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 PC コード ページ グループのメンバーです。

ENUM_CP_ISO

このコード ページは、ISO コード ページ グループのメンバーです。

ENUM_CP_ISO

このコード ページは、ISO コード ページ グループのメンバーです。

ENUM_CP_OEM PC

このコード ページは、OEM PC コード ページ グループのメンバーです。

ENUM_CP_OPEN

このコード ページは、Open Systems コード ページ グループのメンバーです。

ENUM_CP_UCS

このコード ページは、UCS コード ページ グループのメンバーです。

bAvailable

このコード ページがコンピューターにインストールされていることを示すために使用されるブール値。 このメンバーの FALSE の 値は、このコード ページがインストールされているかどうかを判断するためにコンピューターにクエリが実行されないことを示します。 TRUE の値は、コード ページがインストールされていることを示します。

bccsid

コード ページの種類を示すために使用されるフラグ。 このフラグには、次のいずれかを指定できます。

ENUM_CP_DBCS (0x08)

コード ページは、2 バイト文字セット用です。

ENUM_CP_MBCS (0x10)

コード ページは、混合バイト文字セット用です。

ENUM_CP_SBCS (0x20)

コード ページは、1 バイト文字セット用です。

bEuro

このコード ページがユーロ記号をサポートしているかどうかを示すために使用されるブール値。 この値が TRUE の場合、ユーロ記号がサポートされます。

戻り値

FindNextCodePage 関数は、成功した場合に TRUE の値を返します。 失敗した場合、返される値は FALSE です。

注釈

この関数は、ホスト統合サーバー上の SNANLS でサポートされています。