Función RtlInitStringEx (ntifs.h)
La rutina RtlInitStringEx inicializa una cadena con recuento de caracteres de 8 bits.
Sintaxis
NTSYSAPI NTSTATUS RtlInitStringEx(
[out] PSTRING DestinationString,
[in, optional] __drv_aliasesMem PCSZ SourceString
);
Parámetros
[out] DestinationString
Puntero a la estructura STRING que se va a inicializar. El archivo de encabezado Ntdef.h define esta estructura para que sea idéntica a la estructura de ANSI_STRING.
[in, optional] SourceString
Puntero a una cadena de caracteres terminada en NULL. Esta cadena se usa para inicializar la cadena contada a la que apunta DestinationString.
Valor devuelto
Devuelve STATUS_NAME_TOO_LONG si SourceString es demasiado largo. De lo contrario, esta rutina devuelve STATUS_SUCCESS.
Observaciones
Esta rutina inicializa una cadena de caracteres con recuento.
La rutina copia el valor de puntero de SourceString al miembro de buffer de del STRING de estructura a la que apunta DestinationString. El length miembro de esta estructura se establece en la longitud, en bytes, de la cadena de origen, excluyendo el valor NULL de terminación. El miembro MaximumLength de la estructura se establece en la longitud, en bytes, de la cadena de origen, incluido el valor NULL de terminación. Si SourceString es NULL, longitud y MaximumLength se establecen en cero.
rtlInitStringEx no modifica la cadena de origen a la que apunta sourceString.
Los autores de llamadas de RtlInitStringEx se pueden ejecutar en IRQL <= DISPATCH_LEVEL si el búfer de DestinationString no se puede paginar. Normalmente, los llamadores se ejecutan en IRQL = PASSIVE_LEVEL porque la mayoría de las demás rutinas de RtlXxxString no se pueden llamar a en IRQL > PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10. |
| de la plataforma de destino de | Universal |
| encabezado de | ntifs.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | Consulte la sección Comentarios. |