Funzione CompareStringWrapW

[CompareStringWrapW è disponibile per l'uso in Windows XP. Non sarà disponibile nelle versioni successive. È consigliabile usare CompareStringW al suo posto.]

Confronta due stringhe di caratteri Unicode, usando le impostazioni locali specificate.

Nota

CompareStringWrapW è un wrapper per la funzione CompareStringW . Per altre note sull'utilizzo, vedere la pagina CompareString .

 

Sintassi

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

Parametri

Impostazioni locali [in]

Tipo: LCID

Identificatore delle impostazioni locali utilizzato per il confronto. Questo parametro può essere uno degli identificatori delle impostazioni locali predefiniti seguenti o un identificatore delle impostazioni locali creato dalla macro MAKELCID .

LOCALE_SYSTEM_DEFAULT

Impostazioni locali predefinite del sistema.

LOCALE_USER_DEFAULT

Impostazioni locali predefinite dell'utente corrente.

dwCmpFlags [in]

Tipo: DWORD

Flag che indicano come la funzione confronta le due stringhe. Per impostazione predefinita, questi flag non sono impostati. Impostare su zero per ottenere il comportamento predefinito o su qualsiasi combinazione dei valori seguenti.

NORM_IGNORECASE

Ignorare la distinzione tra maiuscole e minuscole

NORM_IGNOREKANATYPE

Non distinguere tra caratteri Hiragana e Katakana. I caratteri Hiragana e Katakana corrispondenti vengono confrontati come uguali.

NORM_IGNORENONSPACE

Ignorare i caratteri senza spaziatura.

NORM_IGNORESYMBOLS

Ignorare i simboli.

NORM_IGNOREWIDTH

Non distinguere tra un carattere a byte singolo e lo stesso carattere di un carattere a byte doppio.

SORT_STRINGSORT

Trattare la punteggiatura come simboli.

lpString1 [in]

Tipo: LPCWSTR

Puntatore alla prima stringa Unicode da confrontare.

cchCount1 [in]

Tipo: int

Numero di caratteri nella stringa a cui punta il parametro lpString1 . Il conteggio non include il carattere null di terminazione. Se questo parametro è un valore negativo, si presuppone che la stringa sia con terminazione Null e la lunghezza viene calcolata automaticamente.

lpString2 [in]

Tipo: LPCWSTR

Puntatore alla seconda stringa Unicode da confrontare.

cchCount2 [in]

Tipo: int

Numero di caratteri nella stringa a cui punta il parametro lpString2 . Il conteggio non include il carattere null di terminazione. Se questo parametro è un valore negativo, si presuppone che la stringa sia con terminazione Null e la lunghezza viene calcolata automaticamente.

Valore restituito

Tipo: int

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError. GetLastError può restituire uno dei codici di errore seguenti.

  • ERROR_INVALID_FLAGS
  • ERROR_INVALID_PARAMETER

Se la funzione ha esito positivo, il valore restituito è uno dei valori seguenti.

Requisito Valore
CSTR_LESS_THAN La stringa a cui punta il parametro lpString1 è minore in valore lessicale rispetto alla stringa a cui punta il parametro lpString2 .
CSTR_EQUAL La stringa a cui punta lpString1 è uguale in valore lessicale alla stringa a cui punta lpString2.
CSTR_GREATER_THAN La stringa a cui punta lpString1 è maggiore in valore lessicale rispetto alla stringa a cui punta lpString2

 

Commenti

Avviso di sicurezza: L'uso di questa funzione in modo non corretto può compromettere la sicurezza dell'applicazione. Le stringhe non confrontate correttamente possono produrre input non valido. Testare le stringhe per assicurarsi che siano valide prima di usarle e fornire gestori degli errori. Per altre informazioni, vedere Considerazioni sulla sicurezza: Funzionalità internazionali

Il metodo preferito consiste nell'usare CompareStringW insieme al livello Microsoft per Unicode (MSLU).

CompareStringWrapW deve essere chiamato direttamente da Shlwapi.dll, usando ordinale 45.

Requisiti

Requisito Valore
Client minimo supportato
 Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato
 Windows Server 2003 [solo app desktop]
Intestazione
Nessuno
DLL
Shlwapi.dll (versione 5.0 o successiva)

Vedi anche

CompareString

 

 

  • Last updated on