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
);
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 |
|---|---|
|
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. |
RtlUnicodeStringValidate 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.
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 | Si las cadenas que se manipulan siempre residen en la memoria, de lo contrario, PASSIVE_LEVEL |