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 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 の場合、ユーロ記号がサポートされます。
戻り値
GetCodePage 関数は、成功した場合に TRUE の値を返します。 失敗した場合、返される値は FALSE です。
注釈
この関数は、ホスト統合サーバー上の SNANLS でサポートされています。