Función RtlInitUTF8StringEx (ntifs.h)

RtlInitUTF8StringEx inicializa una cadena contada 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 para que sea idéntica a la estructura ANSI_STRING .

SourceString

Puntero a una cadena de caracteres terminada en null. SourceString se usa para inicializar la cadena contada a la que apunta DestinationString .

Valor devuelto

RtlInitUTF8StringEx devuelve STATUS_NAME_TOO_LONG si SourceString es demasiado largo. De lo contrario, esta rutina devuelve STATUS_SUCCESS.

Comentarios

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

• Copia el valor de puntero de SourceString en el miembro Buffer .

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

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

Si SourceString es NULL, Length 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 DestinationString no se puede paginar. Normalmente, los llamadores se ejecutan en IRQL = PASSIVE_LEVEL porque no se puede llamar a la mayoría de las demás rutinas rtlXxxString en IRQL > PASSIVE_LEVEL.

Requisitos

Consulte también

ANSI_STRING