Función RtlInitUTF8StringEx (ntifs.h)

RtlInitUTF8StringEx inicializa una cadena con recuento de caracteres UTF-8.

Sintaxis

NTSYSAPI NTSTATUS RtlInitUTF8StringEx(
  PUTF8_STRING          DestinationString,
  __drv_aliasesMem PCSZ SourceString
);

Parámetros

DestinationString

Puntero a la estructura UTF8_STRING que se va a inicializar. El archivo de encabezado ntdef.h define esta estructura como idéntica a la estructura de ANSI_STRING.

SourceString

Puntero a una cadena de caracteres terminada en NULL. SourceString se usa para inicializar la cadena con recuento a la que apunta DestinationString.

Valor devuelto

rtlInitUTF8StringEx devuelve STATUS_NAME_TOO_LONG si el SourceString de es demasiado largo. De lo contrario, esta rutina devuelve STATUS_SUCCESS.

Observaciones

RtlInitUTF8StringEx establece los miembros de la estructura de UTF8_STRING que DestinationString apunta de la siguiente manera:

• Copia el valor de puntero de sourceString en el miembro buffer de.

• Establece el miembro Length longitud, en bytes, de la cadena de origen, excluyendo el valor NULL de terminación.

• Establece el miembro MaximumLength 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, versión 2004
encabezado de	ntifs.h

Consulte también

ANSI_STRING