Función RtlUnicodeStringValidateEx (ntstrsafe.h)
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 |
---|---|
|
Este estado correcto significa que la función se completó correctamente. |
|
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.
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 | Si las cadenas que se manipulan siempre residen en la memoria, de lo contrario, PASSIVE_LEVEL |