FindFirstCodePage

[アーティクル]
07/21/2023

SNA 各国語サポート (SNANLS) FindFirstCodePage 関数は、指定された条件を満たすコードページの最初のインスタンスを検索し、コードページ情報をパラメーターとして渡された構造体にコピーし、 FindNextCodePage 関数の後続の呼び出しで使用されるハンドルを開いて返します。

構文

  
const HANDLE WINAPI FindFirstCodePage(   
        DWORDdwEnumOption,  
        struct CodePage *pPage  
);

パラメーター

dwEnumOption
指定されたパラメーター。コードページが満たす必要がある一連の条件。これらの条件には、SNANLS.h インクルードファイルで定義されている次の値を任意に組み合わせて使用できます。

ENUM_CP_AVAILABLE (0x01)

コードページがインストールされ、使用できます。

ENUM_CP_HOST (0x02)

コードページはホストコードページ (EBCDIC など) です。

ENUM_CP_EURO (0x04)

コードページには、ユーロ文字のサポートが含まれています。

ENUM_CP_DBCS (0x08)

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

ENUM_CP_MBCS (0x10)

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

ENUM_CP_SBCS (0x20)

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

これらの組み合わせの一部は、SNANLS によって使用されるインストールされているコードページと一致しないケースを表していることに注意してください。

pPage
指定され、返されるパラメーター。コードページ情報をコピーする必要がある構造体 CodePage へのポインター。

正常に戻ると、このパラメーターが指すメモリ位置に 、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 表示名。

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 の場合、ユーロ記号がサポートされます。

戻り値

FindFirstCodePage 関数は、成功した場合に FindNextCodePage または FindCloseCodePage の呼び出しで使用されるハンドルを返します。失敗した場合、このハンドルの値に対してINVALID_HANDLE_VALUEが返されます。

注釈

この関数によって返されるハンドルは、ユーザーが改ざんしないでください。

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

次の方法で共有

FindFirstCodePage

構文

パラメーター

戻り値

注釈

その他のリソース