Funzione CompareStringOrdinal (stringapiset.h)

Articolo
08/26/2023

Confronta due stringhe Unicode per testare l'equivalenza binaria.

Sintassi

int CompareStringOrdinal(
  [in] _In_NLS_string_(cchCount1)LPCWCH lpString1,
  [in] int                              cchCount1,
  [in] _In_NLS_string_(cchCount2)LPCWCH lpString2,
  [in] int                              cchCount2,
  [in] BOOL                             bIgnoreCase
);

Parametri

[in] lpString1

Puntatore alla prima stringa da confrontare.

[in] cchCount1

Lunghezza della stringa indicata da lpString1. L'applicazione fornisce -1 se la stringa è terminata con null. In questo caso, la funzione determina automaticamente la lunghezza.

[in] lpString2

Puntatore alla seconda stringa da confrontare.

[in] cchCount2

Lunghezza della stringa indicata da lpString2. L'applicazione fornisce -1 se la stringa è terminata con null. In questo caso, la funzione determina automaticamente la lunghezza.

[in] bIgnoreCase

TRUE se la funzione deve eseguire un confronto senza distinzione tra maiuscole e minuscole usando le informazioni sulla tabella maiuscola del sistema operativo. L'applicazione imposta questo parametro su FALSE se la funzione consiste nel confrontare le stringhe esattamente come vengono passate. Si noti che 1 è l'unico valore numerico che può essere usato per specificare un valore true per questo parametro booleano che non genera un errore di parametro non valido. I valori booleani per questo parametro funzionano come previsto.

Valore restituito

Restituisce uno dei valori seguenti se ha esito positivo. Per mantenere la convenzione di runtime C delle stringhe di confronto, il valore 2 può essere sottratto da un valore restituito diverso da zero. Il significato di <0, ==0 e >0 è quindi coerente con il runtime C.

CSTR_LESS_THAN. Il valore indicato da lpString1 è minore del valore indicato da lpString2.
CSTR_EQUAL. Il valore indicato da lpString1 equivale al valore indicato da lpString2.
CSTR_GREATER_THAN. Il valore indicato da lpString1 è maggiore del valore indicato da lpString2.

La funzione restituisce 0 se non riesce. Per ottenere informazioni sull'errore estese, l'applicazione può chiamare GetLastError, che può restituire uno dei codici di errore seguenti:

ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.

Commenti

Questa funzione verifica l'uguaglianza binaria, non l'uguaglianza linguistica. Per informazioni sull'uso della funzione per l'ordinamento ordinale, vedere Gestione dell'ordinamento nelle applicazioni.

Le applicazioni interessate all'uguaglianza linguistica devono usare CompareString, CompareStringEx, lstrcmp o lstrcmpi. Per altre informazioni sull'ordinamento linguistico, vedere Gestione dell'ordinamento nelle applicazioni

A partire da Windows 8: CompareStringOrdinal è dichiarato in Stringapiset.h. Prima di Windows 8, è stato dichiarato in Winnls.h.

Requisiti


Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	stringapiset.h (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll