FindFirstCodePage

Die Funktion SNA National Language Support (SNANLS) FindFirstCodePage findet die erste Instanz einer Codeseite, die die angegebene Bedingung erfüllt, kopiert die Codeseiteninformationen in eine Struktur, die als Parameter übergeben wird, und öffnet und gibt ein Handle zurück, das in nachfolgenden Aufrufen der FindNextCodePage-Funktion verwendet wird.

Syntax

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

Parameter

dwEnumOption
Angegebener Parameter. Die Gruppe der Bedingungen, die eine Codeseite erfüllen soll. Diese Bedingungen können eine beliebige Kombination der folgenden Werte sein, die in der Datei SNANLS.h definiert sind:

ENUM_CP_AVAILABLE (0x01)

Die Codeseite ist installiert und für die Verwendung verfügbar.

ENUM_CP_HOST (0x02)

Die Codeseite ist eine Hostcodeseite (z. B. EBCDIC).

ENUM_CP_EURO (0x04)

Die Codeseite enthält Unterstützung für das Eurozeichen.

ENUM_CP_DBCS (0x08)

Die Codeseite ist für einen Doppelbyte-Zeichensatz vorgesehen.

ENUM_CP_MBCS (0x10)

Die Codeseite ist für einen Gemischt-Byte-Zeichensatz vorgesehen.

ENUM_CP_SBCS (0x20)

Die Codeseite ist für einen Einzelbyte-Zeichensatz vorgesehen.

Beachten Sie, dass einige dieser Kombinationen Fälle darstellen, die nicht mit installierten Codeseiten übereinstimmen, die von SNANLS verwendet werden.

pPage
Der angegebene und zurückgegebene Parameter. Ein Zeiger auf eine CodePage-Struktur, auf der die Codeseiteninformationen kopiert werden sollen.

Bei einer erfolgreichen Rückgabe wird der von diesem Parameter angegebene Speicherspeicherort mit den Informationen für die erste Codepage gefüllt, die die Bedingungen in dwEnumOption erfüllt. Bei Einem Fehler werden keine Änderungen am Speicher vorgenommen, auf den dieser Parameter verweist.

Die CodePage-Struktur wird in SNANLS definiert. H include file as follows:

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 beliebig von Service Packs geändert werden kann, wenn zusätzliche Codeseiten unterstützt werden.

CodePageID

Die NLS-Codeseitenzahl.

szFriendlyName

Der SNANLS-Anzeigename für diese Codeseite.

eGroup

Die Gruppe, durch die diese Codeseite dargestellt wird. . Dieser Wert kann eine der folgenden Enumerationen sein, die in der Datei "SNANLS.h include" für Codegruppen definiert sind:

ENUM_CP_EBCDIC

Diese Codeseite ist ein Mitglied der EBCDIC-Codeseitengruppe.

ENUM_CP_ANSI

Diese Codeseite ist ein Mitglied der ANSI-Codeseitengruppe.

ENUM_CP_ISO

Diese Codeseite ist Ein Mitglied der ISO-Codeseitengruppe.

ENUM_CP_OEMPC

Diese Codeseite ist Ein Mitglied der OEM-PC-Codeseitengruppe.

ENUM_CP_ISO

Diese Codeseite ist Ein Mitglied der ISO-Codeseitengruppe.

ENUM_CP_ISO

Diese Codeseite ist Ein Mitglied der ISO-Codeseitengruppe.

ENUM_CP_OEM PC

Diese Codeseite ist Ein Mitglied der OEM-PC-Codeseitengruppe.

ENUM_CP_OPEN

Diese Codeseite ist Ein Mitglied der Codepagegruppe "Open Systems".

ENUM_CP_UCS

Diese Codeseite ist ein Mitglied der UCS-Codeseitengruppe.

bAvailable

Ein boolescher Wert, der verwendet wird, um anzugeben, dass diese Codeseite auf dem Computer installiert ist. Ein Wert von FALSE für dieses Element gibt an, dass der Computer nicht abgefragt wird, um festzustellen, ob diese Codepage installiert ist. Ein Wert von TRUE gibt an, dass die Codepage installiert ist.

bccsid

Ein Kennzeichen, das verwendet wird, um den Typ der Codeseite anzugeben. Dieses Kennzeichen kann eine der folgenden Sein:

ENUM_CP_DBCS (0x08)

Die Codeseite ist für einen Doppelbyte-Zeichensatz vorgesehen.

ENUM_CP_MBCS (0x10)

Die Codeseite ist für einen Gemischt-Byte-Zeichensatz vorgesehen.

ENUM_CP_SBCS (0x20)

Die Codeseite ist für einen Einzelbyte-Zeichensatz vorgesehen.

bEuro

Ein boolescher Wert, der angibt, ob diese Codeseite das Euro-Symbol unterstützt. Wenn dieser Wert WAHR ist, wird das Eurosymbol unterstützt.

Rückgabewert

Die FindFirstCodePage-Funktion gibt ein Handle zurück, das in Aufrufen von FindNextCodePage oder FindCloseCodePage bei Erfolg verwendet wird. Bei Einem Fehler wird INVALID_HANDLE_VALUE für den Wert dieses Handles zurückgegeben.

Bemerkungen

Das von dieser Funktion zurückgegebene Handle sollte nicht vom Benutzer manipuliert werden.

Diese Funktion wird von SNANLS auf hostintegrationsserver unterstützt.