StrCmpNA-Funktion (shlwapi.h)

  • Artikel

Vergleicht eine angegebene Anzahl von Zeichen vom Anfang von zwei Zeichenfolgen, um zu bestimmen, ob sie identisch sind. Beim Vergleich wird die Groß-/Kleinschreibung beachtet. Das StrNCmp-Makro unterscheidet sich von dieser Funktion nur durch den Namen.

Syntax

int StrCmpNA(
  [in] PCSTR psz1,
  [in] PCSTR psz2,
  [in] int   nChar
);

Parameter

[in] psz1

Typ: PCTSTR

Ein Zeiger auf die erste NULL-Zeichenfolge, die verglichen werden soll.

[in] psz2

Typ: PCTSTR

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

[in] nChar

Typ: int

Die Anzahl der Zeichen vom Anfang jeder zu vergleichenden Zeichenfolge.

Rückgabewert

Typ: int

Gibt null zurück, wenn die Zeichenfolgen identisch sind. Gibt einen positiven Wert zurück, wenn die ersten nChar-Zeichen der Zeichenfolge, auf die von psz1 verwiesen wird, größer sind als die Zeichen der Zeichenfolge, auf die von psz2 verwiesen wird. Es gibt einen negativen Wert zurück, wenn die ersten nChar-Zeichen der Zeichenfolge, auf die von psz1 verwiesen wird, kleiner sind als die Zeichen der Zeichenfolge, auf die von psz2 verwiesen wird.

Hinweise

Hinweis

Der shlwapi.h-Header definiert StrCmpN 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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
Bibliothek Shlwapi.lib
DLL Shlwapi.dll (Version 4.71 oder höher)