FindFirstCodePage

Die SNANLS-Funktion FindFirstCodePage (SNA National Language Support) findet die erste instance einer Codepage, die die angegebene Bedingung erfüllt, kopiert die Codepageinformationen in eine Struktur, die als Parameter übergeben wurde, 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. Der Satz von Bedingungen, die eine Codepage erfüllen soll. Diese Bedingungen können eine beliebige Kombination der folgenden Werte sein, die in der Includedatei SNANLS.h definiert sind:

ENUM_CP_AVAILABLE (0x01)

Die Codepage ist installiert und steht zur Verwendung zur Verfügung.

ENUM_CP_HOST (0x02)

Die Codepage ist eine Hostcodepage (z. B. EBCDIC).

ENUM_CP_EURO (0x04)

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

ENUM_CP_DBCS (0x08)

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

ENUM_CP_MBCS (0x10)

Die Codepage ist für einen Zeichensatz mit gemischten Bytezeichen vorgesehen.

ENUM_CP_SBCS (0x20)

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

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

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

Bei erfolgreicher Rückgabe wird der Speicherspeicherort, auf den dieser Parameter verweist, 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 ist im 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 Elemente dieser CodePage-Struktur sind wie folgt:

CodePageKey

Ein numerischer Wert, der den Index in das 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 Codeseiten unterstützt werden.

CodePageID

Die NLS-Codepagenummer.

szFriendlyName

Der SNANLS-Anzeigename für diese Codepage.

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 Ein Mitglied der ANSI-Codepagegruppe.

ENUM_CP_ISO

Diese Codepage ist Ein Mitglied der ISO-Codepagegruppe.

ENUM_CP_OEMPC

Diese Codepage ist Ein Mitglied der OEM-PC-Codepagegruppe.

ENUM_CP_ISO

Diese Codepage ist Ein Mitglied der ISO-Codepagegruppe.

ENUM_CP_ISO

Diese Codepage ist Ein Mitglied der ISO-Codepagegruppe.

ENUM_CP_OEM PC

Diese Codepage ist Ein Mitglied der OEM-PC-Codepagegruppe.

ENUM_CP_OPEN

Diese Codepage ist Ein Mitglied der Codepagegruppe Open Systems.

ENUM_CP_UCS

Diese Codepage ist Ein Mitglied der UCS-Codepagegruppe.

bAvailable

Ein boolescher Wert, der verwendet wird, um anzugeben, dass diese Codepage auf dem Computer installiert ist. Der Wert FALSE für dieses Element 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 eines der folgenden sein:

ENUM_CP_DBCS (0x08)

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

ENUM_CP_MBCS (0x10)

Die Codepage ist für einen Zeichensatz mit gemischten Bytezeichen vorgesehen.

ENUM_CP_SBCS (0x20)

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

bEuro

Ein boolescher Wert, der verwendet wird, um anzugeben, ob diese Codepage das Euro-Symbol unterstützt. Wenn dieser Wert TRUE ist, wird das Euro-Symbol unterstützt.

Rückgabewert

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

Hinweise

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

Diese Funktion wird von SNANLS auf Host Integration Server unterstützt.