Funzione StrCmpNIW (shlwapi.h)

Articolo
03/15/2023

Confronta un numero specificato di caratteri dall'inizio di due stringhe per determinare se sono uguali. Nel confronto non viene fatta distinzione tra maiuscole e minuscole. La macro StrNCmpI è diversa da questa funzione solo nel nome.

Sintassi

int StrCmpNIW(
  [in] PCWSTR psz1,
  [in] PCWSTR psz2,
  [in] int    nChar
);

Parametri

[in] psz1

Tipo: PCTSTR

Puntatore alla prima stringa con terminazione Null da confrontare.

[in] psz2

Tipo: PCTSTR

Puntatore alla seconda stringa con terminazione Null da confrontare.

[in] nChar

Tipo: int

Numero di caratteri dall'inizio di ogni stringa da confrontare.

Valore restituito

Tipo: int

Restituisce zero se le stringhe sono identiche. Restituisce un valore positivo se i primi caratteri nChar della stringa a cui punta psz1 sono maggiori di quelli della stringa a cui punta psz2. Restituisce un valore negativo se i primi caratteri nChar della stringa a cui punta psz1 sono minori di quelli della stringa a cui punta psz2.

Commenti

Nota

L'intestazione shlwapi.h definisce StrCmpNI come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 4.71 o successiva)

Condividi tramite