Funzione RtlUnicodeStringValidate (ntstrsafe.h)
La funzione RtlUnicodeStringValidate convalida il contenuto di una struttura UNICODE_STRING .
Sintassi
NTSTRSAFEDDI RtlUnicodeStringValidate(
[in] PCUNICODE_STRING SourceString
);
Parametri
[in] SourceString
Puntatore a una struttura UNICODE_STRING da convalidare.
Valore restituito
RtlUnicodeStringValidate restituisce uno dei valori NTSTATUS seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Questo stato di esito positivo significa che la funzione è stata completata correttamente. |
|
Questo stato di errore indica che la funzione ha ricevuto un parametro di input non valido. Per altre informazioni, vedere l'elenco seguente. |
RtlUnicodeStringValidate restituisce il valore di STATUS_INVALID_PARAMETER quando si verifica una delle operazioni seguenti:
- SourceString->La lunghezza % sizeof(WCHAR) non è uguale a zero.
- SourceString->MaximumLength % sizeof(WCHAR) non è uguale a zero.
- SourceString->La lunghezza è maggiore di SourceString->MaximumLength.
- SourceString->MaximumLength è maggiore di NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).
- SourceString->Il buffer è uguale a NULL, ma SourceStringLength o SourceString->->MaximumLength non è uguale a zero.
Commenti
Il puntatore SourceString non può essere NULL. Se è necessario specificare un valore del puntatore NULL , usare la funzione RtlUnicodeStringValidateEx .
Per altre informazioni sulle funzioni di stringa sicura, vedere Uso di funzioni stringhe sicure.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows XP con Service Pack 1 (SP1) e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | ntstrsafe.h (include Ntstrsafe.h) |
| Libreria | Ntstrsafe.lib |
| IRQL | Qualsiasi se le stringhe modificate sono sempre residenti in memoria, in caso contrario PASSIVE_LEVEL |