Función RtlUnicodeStringValidate (ntstrsafe.h)

  • Artículo

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

Sintaxis

NTSTRSAFEDDI RtlUnicodeStringValidate(
  [in] PCUNICODE_STRING SourceString
);

Parámetros

[in] SourceString

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

Valor devuelto

RtlUnicodeStringValidate devuelve uno de los siguientes valores NTSTATUS.

Código devuelto Descripción
STATUS_SUCCESS
 Este estado correcto significa que la función se completó correctamente.
STATUS_INVALID_PARAMETER
 Este estado de error 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->La 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 Uso de valores NTSTATUS.

Comentarios

El puntero SourceString no puede ser 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, consulte Uso de funciones de cadena segura.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows XP con Service Pack 1 (SP1) y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado ntstrsafe.h (incluya Ntstrsafe.h)
Library Ntstrsafe.lib
IRQL PASSIVE_LEVEL

Consulte también

RtlUnicodeStringValidateEx

UNICODE_STRING