Función RtlUnicodeStringValidate (ntstrsafe.h)

La función RtlUnicodeStringValidate valida el contenido de una estructura de UNICODE_STRING.

Sintaxis

NTSTRSAFEDDI RtlUnicodeStringValidate(
  [in] PCUNICODE_STRING SourceString
);

[in] SourceString

Puntero a una estructura de UNICODE_STRING que se va a validar.

rtlUnicodeStringValidate devuelve uno de los siguientes valores NTSTATUS.

Código devuelto	Descripción
STATUS_SUCCESS	Este correcto estado significa que la función se completó correctamente.
STATUS_INVALID_PARAMETER	Este error estado significa que la función recibió un parámetro de entrada no válido. Para obtener más información, consulte la lista siguiente.

rtlUnicodeStringValidate devuelve el valor de STATUS_INVALID_PARAMETER cuando se produce una de las siguientes acciones:

SourceString->Length % sizeof(WCHAR) no es igual a cero.
SourceString->MaximumLength % sizeof(WCHAR) no es igual a cero.
sourceString->Longitud es mayor que SourceString->MaximumLength.
sourceString-> MaximumLength es mayor que NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).
SourceString->Buffer es igual a NULL, pero SourceString->Length o SourceString->MaximumLength no es igual a cero.

Para obtener información sobre cómo probar valores NTSTATUS, vea Using NTSTATUS Values.

El puntero sourceString de no se puede NULL. Si necesita especificar un valor de puntero NULL, use la función RtlUnicodeStringValidateEx.

Para obtener más información sobre las funciones de cadena segura, vea Using Safe String Functions.

Requisito	Valor
cliente mínimo admitido	Disponible en Windows XP con Service Pack 1 (SP1) y versiones posteriores de Windows.
de la plataforma de destino de	Escritorio
encabezado de	ntstrsafe.h (incluya Ntstrsafe.h)
biblioteca de	Ntstrsafe.lib
irQL	Si las cadenas que se manipulan siempre residen en la memoria, de lo contrario, PASSIVE_LEVEL