Función RtlUnicodeStringValidateEx (ntstrsafe.h)

  • Artículo

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

Sintaxis

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

Parámetros

[in] SourceString

Opcional. Puntero a una estructura de UNICODE_STRING que se va a validar. Este puntero puede ser NULL, pero solo si STRSAFE_IGNORE_NULLS está establecido en dwFlags.

[in] dwFlags

Se define la marca siguiente:

STRSAFE_IGNORE_NULLS

Si se establece esta marca, el puntero de origen puede ser NULL. RtlUnicodeStringValidateEx trata punteros de búfer de origen NULL como cadenas vacías (TEXT("")).

Valor devuelto

RtlUnicodeStringValidateEx 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.
 

Si no se establece STRSAFE_IGNORE_NULLS en dwFlags, RtlUnicodeStringValidateEx devuelve el valor 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.
  • Se especifica una marca no válida para dwFlags.
Para obtener información sobre cómo probar valores NTSTATUS, vea Uso de valores NTSTATUS.

Comentarios

El puntero SourceString no puede ser NULL a menos que se establezca la marca STRSAFE_IGNORE_NULLS.

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

RtlUnicodeStringValidate

UNICODE_STRING