Funzione FindNLSString (winnls.h)

Articolo
03/13/2024

Individua una stringa Unicode (caratteri wide) o l'equivalente in un'altra stringa Unicode per le impostazioni locali specificate dall'identificatore.

Attenzione Poiché le stringhe con rappresentazioni binarie molto diverse possono essere confrontate come identiche, questa funzione può generare determinati problemi di sicurezza. Per altre informazioni, vedere la discussione sulle funzioni di confronto in Considerazioni sulla sicurezza: Funzionalità internazionali.

Nota Per motivi di interoperabilità, l'applicazione deve preferire la funzione FindNLSStringEx perché Microsoft sta eseguendo la migrazione all'uso dei nomi delle impostazioni locali anziché degli identificatori delle impostazioni locali per le nuove impostazioni locali. Sebbene FindNLSString supporti impostazioni locali personalizzate, la maggior parte delle applicazioni deve usare FindNLSStringEx per questo tipo di supporto.

Sintassi

int FindNLSString(
  [in]            LCID    Locale,
  [in]            DWORD   dwFindNLSStringFlags,
  [in]            LPCWSTR lpStringSource,
  [in]            int     cchSource,
  [in]            LPCWSTR lpStringValue,
  [in]            int     cchValue,
  [out, optional] LPINT   pcchFound
);

Parametri

[in] Locale

Identificatore delle impostazioni locali che specifica le impostazioni locali. È possibile utilizzare la macro MAKELCID per creare un identificatore o usare uno dei valori predefiniti seguenti.

Windows Vista e versioni successive: Sono supportati anche gli identificatori di impostazioni locali personalizzati seguenti.

[in] dwFindNLSStringFlags

Flag che specificano i dettagli dell'operazione di ricerca. Per definizioni dettagliate, vedere il parametro dwFindNLSStringFlags di FindNLSStringEx.

[in] lpStringSource

Puntatore alla stringa di origine, in cui la funzione cerca la stringa specificata da lpStringValue.

[in] cchSource

Dimensioni, in caratteri esclusi il carattere Null di terminazione, della stringa indicata da lpStringSource. L'applicazione non può specificare 0 o nessun numero negativo diverso da -1 per questo parametro. L'applicazione specifica -1 se la stringa di origine è con terminazione Null e la funzione deve calcolare automaticamente le dimensioni.

[in] lpStringValue

Puntatore alla stringa di ricerca, per cui la funzione esegue la ricerca nella stringa di origine.

[in] cchValue

Dimensioni, in caratteri esclusi il carattere Null di terminazione, della stringa indicata da lpStringValue. L'applicazione non può specificare 0 o nessun numero negativo diverso da -1 per questo parametro. L'applicazione specifica -1 se la stringa di ricerca è con terminazione Null e la funzione deve calcolare automaticamente le dimensioni.

[out, optional] pcchFound

Puntatore a un buffer contenente la lunghezza della stringa trovata dalla funzione. Per informazioni dettagliate, vedere il parametro pcchFound di FindNLSStringEx.

Valore restituito

Restituisce un indice in base 0 nella stringa di origine indicata da lpStringSource se l'operazione riesce. In combinazione con il valore in pcchFound, questo indice fornisce la posizione esatta dell'intera stringa trovata nella stringa di origine. Il valore restituito 0 è un indice senza errori nella stringa di origine e la stringa corrispondente si trova nella stringa di origine in corrispondenza dell'offset 0.

Se la funzione non riesce, restituisce -1. Per ottenere informazioni estese sull'errore, l'applicazione può chiamare GetLastError, che può restituire uno dei codici di errore seguenti:

ERROR_INVALID_FLAGS. I valori specificati per i flag non sono validi.
ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.
ERROR_SUCCESS. L'azione è stata completata correttamente, ma non ha restituito risultati.

Commenti

Vedere la sezione Osservazioni per FindNLSStringEx.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winnls.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll