CompareStringWrapW-Funktion

[CompareStringWrapW ist für die Verwendung in Windows XP verfügbar. Sie ist in nachfolgenden Versionen nicht verfügbar. Sie sollten compareStringW an seiner Stelle verwenden.]

Vergleicht zwei Unicode-Zeichenfolgen mithilfe eines angegebenen Gebietsschemas.

Hinweis

CompareStringWrapW ist ein Wrapper für die CompareStringW-Funktion . Weitere Hinweise zur Verwendung finden Sie auf der Seite CompareString .

 

Syntax

int CompareStringWrapW(
  _In_ LCID    Locale,
  _In_ DWORD   dwCmpFlags,
  _In_ LPCWSTR lpString1,
  _In_ int     cchCount1,
  _In_ LPCWSTR lpString2,
  _In_ int     cchCount2
);

Parameter

Gebietsschema [in]

Typ: LCID

Ein Gebietsschemabezeichner, der für den Vergleich verwendet wird. Bei diesem Parameter kann es sich um einen der folgenden vordefinierten Gebietsschemabezeichner oder um einen Gebietsschemabezeichner handeln, der vom MAKELCID-Makro erstellt wurde.

LOCALE_SYSTEM_DEFAULT

Das Standardgebietsschema des Systems.

LOCALE_USER_DEFAULT

Das Standardgebietsschema des aktuellen Benutzers.

dwCmpFlags [in]

Art: DWORD

Die Flags, die angeben, wie die Funktion die beiden Zeichenfolgen vergleicht. Standardmäßig sind diese Flags nicht festgelegt. Legen Sie auf null fest, um das Standardverhalten oder eine beliebige Kombination der folgenden Werte abzurufen.

NORM_IGNORECASE

Groß-/Kleinschreibung ignorieren.

NORM_IGNOREKANATYPE

Unterscheiden Sie nicht zwischen Hiragana- und Katakana-Zeichen. Die entsprechenden Hiragana- und Katakana-Zeichen sind gleich.

NORM_IGNORENONSPACE

Ignorieren von Zeichen ohne Zeichenfolgen

NORM_IGNORESYMBOLS

Symbole ignorieren.

NORM_IGNOREWIDTH

Unterscheiden Sie nicht zwischen einem Einzelbytezeichen und demselben Zeichen wie ein Doppelbytezeichen.

SORT_STRINGSORT

Behandeln Sie Interpunktion genauso wie Symbole.

lpString1 [in]

Typ: LPCWSTR

Ein Zeiger auf die erste zu vergleichende Unicode-Zeichenfolge.

cchCount1 [in]

Typ: int

Die Anzahl der Zeichen in der Zeichenfolge, auf die der lpString1-Parameter verweist. Die Anzahl enthält nicht das abschließende NULL-Zeichen. Wenn dieser Parameter ein negativer Wert ist, wird angenommen, dass die Zeichenfolge NULL-beendet ist, und die Länge wird automatisch berechnet.

lpString2 [in]

Typ: LPCWSTR

Ein Zeiger auf die zweite unicode-Zeichenfolge, die verglichen werden soll.

cchCount2 [in]

Typ: int

Die Anzahl der Zeichen in der Zeichenfolge, auf die der lpString2-Parameter verweist. Die Anzahl enthält nicht das abschließende NULL-Zeichen. Wenn dieser Parameter ein negativer Wert ist, wird angenommen, dass die Zeichenfolge NULL-beendet ist, und die Länge wird automatisch berechnet.

Rückgabewert

Typ: int

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. GetLastError gibt möglicherweise einen der folgenden Fehlercodes zurück.

• ERROR_INVALID_FLAGS
• ERROR_INVALID_PARAMETER

Wenn die Funktion erfolgreich ist, ist der Rückgabewert einer der folgenden Werte.

Anforderung	Wert
CSTR_LESS_THAN	Die Zeichenfolge, auf die der parameter lpString1 verweist, ist im lexikalischen Wert kleiner als die Zeichenfolge, auf die der lpString2-Parameter verweist.
CSTR_EQUAL	Die Zeichenfolge, auf die von lpString1 verwiesen wird, ist im lexikalischen Wert gleich der Zeichenfolge, auf die lpString2 verweist.
CSTR_GREATER_THAN	Die Zeichenfolge, auf die von lpString1 verwiesen wird, ist im lexikalischen Wert größer als die Zeichenfolge, auf die lpString2 verweist.

 

Bemerkungen

Sicherheitswarnung: Die falsche Verwendung dieser Funktion kann die Sicherheit Ihrer Anwendung beeinträchtigen. Zeichenfolgen, die nicht ordnungsgemäß verglichen werden, können ungültige Eingaben erzeugen. Testen Sie Zeichenfolgen, um sicherzustellen, dass sie gültig sind, bevor Sie sie verwenden, und stellen Sie Fehlerhandler bereit. Weitere Informationen finden Sie unter Sicherheitsüberlegungen: Internationale Features.

Die bevorzugte Methode ist die Verwendung von CompareStringW in Verbindung mit Microsoft Layer for Unicode (MSLU).

CompareStringWrapW muss direkt aus Shlwapi.dll mithilfe von Ordinal 45 aufgerufen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Keine
DLL	Shlwapi.dll (Version 5.0 oder höher)

Siehe auch

CompareString