Funzione RtlUnicodeStringValidateEx (ntstrsafe.h)

Articolo
05/03/2024

La funzione RtlUnicodeStringValidateEx convalida il contenuto di una struttura UNICODE_STRING .

Sintassi

NTSTRSAFEDDI RtlUnicodeStringValidateEx(
  [in] PCUNICODE_STRING SourceString,
  [in] DWORD            dwFlags
);

Parametri

[in] SourceString

Facoltativo. Puntatore a una struttura UNICODE_STRING da convalidare. Questo puntatore può essere NULL, ma solo se STRSAFE_IGNORE_NULLS è impostato in dwFlags.

[in] dwFlags

Viene definito il flag seguente:

STRSAFE_IGNORE_NULLS

Se questo flag è impostato, il puntatore di origine può essere NULL. RtlUnicodeStringValidateEx considera i puntatori del buffer di origine NULL come stringhe vuote (TEXT("")).

Valore restituito

RtlUnicodeStringValidateEx restituisce uno dei valori NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	Questo stato di esito positivo indica che la funzione è stata completata correttamente.
STATUS_INVALID_PARAMETER	Questo stato di errore indica che la funzione ha ricevuto un parametro di input non valido. Per altre informazioni, vedere l'elenco seguente.

Se STRSAFE_IGNORE_NULLS non è impostato in dwFlags, RtlUnicodeStringValidateEx restituisce il valore STATUS_INVALID_PARAMETER quando si verifica una delle condizioni 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->Buffer è uguale a NULL , ma SourceString->Length o SourceString->MaximumLength non è uguale a zero.
Per dwFlags viene specificato un flag non valido.

Per informazioni su come testare i valori NTSTATUS, vedere Utilizzo di valori NTSTATUS.

Commenti

Il puntatore SourceString non può essere NULL a meno che non sia impostato il flag di STRSAFE_IGNORE_NULLS.

Per altre informazioni sulle funzioni di stringa sicura, vedere Using Safe String Functions.For more information about the safe string functions, see Using Safe String Functions.

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	Se le stringhe modificate sono sempre residenti in memoria, in caso contrario PASSIVE_LEVEL

Vedi anche

RtlUnicodeStringValidate

UNICODE_STRING

Condividi tramite