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
STATUS_SUCCESS	Questo stato di esito positivo significa 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.

 

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.

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

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

Vedi anche

RtlUnicodeStringValidateEx

UNICODE_STRING