GetCodePage
Die SNANLS-Funktion GetCodePage (SNA National Language Support) kopiert die codepage-Informationen, die durch einen Schlüssel identifiziert werden, in eine Struktur, die als Parameter übergeben wird.
Syntax
BOOL WINAPI GetCodePage(
Int nKey
struct CodePage *pPage
);
Parameter
nKey
Angegebener Parameter. Der numerische Schlüssel für eine Codepage. Dieser Wert ist ein undurchsichtiger Index in ein Array, das die von SNANLS unterstützten Codepages enthält. Dieser Wert ist normalerweise das CodePageKey-Element einer CodePage-Struktur, die von einem vorherigen Aufruf von FindFirstCodePage oder FindNextCodePage zurückgegeben wurde.
pPage
Angegebener und zurückgegebener Parameter. Ein Zeiger auf die Struktur von CodePage, in die die Codepageinformationen kopiert werden sollen.
Bei einer erfolgreichen Rückgabe wird der Speicherspeicherort, auf den dieser Parameter verweist, mit den Informationen für die spezifische Codepage gefüllt.
Bei einem Fehler werden keine Änderungen am Speicher vorgenommen, auf den dieser Parameter verweist.
Die CodePage-Struktur ist in SNANLS definiert. H include-Datei wie folgt:
struct CodePage {
BYTE CodePageKey;
DWORD CodePageID;
WCHAR szFriendlyName[CP_SIZE];
short eGroup;
BOOL bAvailable;
BYTE bccsid;
BOOL bEuro;
};
Die Member dieser CodePage-Struktur sind wie folgt:
CodePageKey
Ein numerischer Wert, der den Index im Array von CodePage-Strukturen darstellt. Dieser Wert sollte als undurchsichtiger Wert verwendet werden, da dieser Wert von Service Packs beliebig geändert werden kann, wenn zusätzliche Codepages unterstützt werden.
CodePageID
Die NLS-Codepagenummer.
szFriendlyName
Der SNANLS-Anzeigename für diese Codepage. Die Zeichenfolge ist null beendet.
eGroup
Die Gruppe, durch die diese Codepage dargestellt wird. . Dieser Wert kann eine der folgenden Enumerationen sein, die in der Includedatei SNANLS.h für Codegruppen definiert sind:
ENUM_CP_EBCDIC
Diese Codepage ist Mitglied der EBCDIC-Codepagegruppe.
ENUM_CP_ANSI
Diese Codepage ist Mitglied der ANSI-Codepagegruppe.
ENUM_CP_ISO
Diese Codepage ist Mitglied der ISO-Codepagegruppe.
ENUM_CP_OEMPC
Diese Codepage ist Mitglied der OEM-PC-Codepagegruppe.
ENUM_CP_ISO
Diese Codepage ist Mitglied der ISO-Codepagegruppe.
ENUM_CP_ISO
Diese Codepage ist Mitglied der ISO-Codepagegruppe.
ENUM_CP_OEM PC
Diese Codepage ist Mitglied der OEM-PC-Codepagegruppe.
ENUM_CP_OPEN
Diese Codepage ist Mitglied der Codepagegruppe Open Systems.
ENUM_CP_UCS
Diese Codepage ist Mitglied der UCS-Codepagegruppe.
b Verfügbar
Ein boolescher Wert, der verwendet wird, um anzugeben, dass diese Codepage auf dem Computer installiert ist. Der Wert FALSE für diesen Member gibt an, dass der Computer nicht abgefragt wird, um festzustellen, ob diese Codepage installiert ist. Der Wert TRUE gibt an, dass die Codepage installiert ist.
bccsid
Ein Flag, das verwendet wird, um den Typ der Codepage anzugeben. Dieses Flag kann wie folgt aussehen:
ENUM_CP_DBCS (0x08)
Die Codepage ist für einen Doppelbytezeichensatz vorgesehen.
ENUM_CP_MBCS (0x10)
Die Codepage ist für einen gemischten Bytezeichensatz vorgesehen.
ENUM_CP_SBCS (0x20)
Die Codepage ist für einen Einzelbytezeichensatz vorgesehen.
bEuro
Ein boolescher Wert, der angibt, ob diese Codepage das Euro-Symbol unterstützt. Wenn dieser Wert TRUE ist, wird das Eurosymbol unterstützt.
Rückgabewert
Die GetCodePage-Funktion gibt bei Erfolg den Wert TRUE zurück. Bei einem Fehler ist der zurückgegebene Wert FALSE.
Hinweise
Diese Funktion wird von SNANLS auf Host Integration Server unterstützt.