StrIsIntlEqualA-Funktion (shlwapi.h)

Artikel
11/20/2024

Vergleicht eine angegebene Anzahl von Zeichen vom Anfang zweier Zeichenfolgen, um festzustellen, ob sie gleich sind.

Syntax

BOOL StrIsIntlEqualA(
       BOOL  fCaseSens,
  [in] PCSTR pszString1,
  [in] PCSTR pszString2,
       int   nChar
);

Parameter

fCaseSens

Typ: BOOL-

Die Groß-/Kleinschreibung des Vergleichs. Wenn dieser Wert nicht null ist, wird bei dem Vergleich die Groß-/Kleinschreibung beachtet. Wenn dieser Wert null ist, wird bei dem Vergleich die Groß-/Kleinschreibung nicht beachtet.

[in] pszString1

Typ: PCTSTR-

Ein Zeiger auf die erste mit Null beendete Zeichenfolge, die verglichen werden soll.

[in] pszString2

Typ: PCTSTR-

Ein Zeiger auf die zweite mit Null beendete Zeichenfolge, die verglichen werden soll.

nChar

Typ: int

Die Anzahl der Zeichen vom Anfang jeder zu vergleichenden Zeichenfolge.

Rückgabewert

Typ: BOOL-

TRUE, wenn die ersten nChar- Zeichen aus den beiden Zeichenfolgen gleich sind; andernfalls FALSE.

Bemerkungen

Sie können die Groß-/Kleinschreibung mit den StrIntlEqN- und StrIntlEqNI- Makros festlegen. StrIntlEqN- führt einen Vergleich zwischen Groß- und Kleinschreibung durch, und StrIntlEqNI- führt einen Vergleich zwischen Groß- und Kleinschreibung durch.

Die Syntax der beiden Makros lautet:

#define StrIntlEqN(s1, s2, nChar) StrIsIntlEqual(TRUE, s1, s2, nChar)
#define StrIntlEqNI(s1, s2, nChar) StrIsIntlEqual(FALSE, s1, s2, nChar)

Anmerkung

Der Header "shlwapi.h" definiert StrIsIntlEqual als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 4.71 oder höher)

Freigeben über