Compartir a través de

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

Si no se establece STRSAFE_IGNORE_NULLS en dwFlags, rtlUnicodeStringValidateEx 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:>Longitud 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 Using NTSTATUS Values.

Observaciones

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

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

Requisitos

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

Consulte también

RtlUnicodeStringValidate

UNICODE_STRING