Función RtlInitUTF8StringEx (wdm.h)

La rutina 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 STRING .

SourceString

Un 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.

Comentarios

La rutina copia el valor del puntero SourceString al miembro Buffer de la estructura de UTF8_STRING a la que apunta DestinationString. El miembro Length 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, incluida la terminación null. Si SourceString es NULL, Length y MaximumLength se establecen en cero.

RtlInitUTF8StringEx no modifica la cadena de origen a la que apunta SourceString.

Los autores de llamadas de RtlInitUTF8StringEx se pueden ejecutar en IRQL <= DISPATCH_LEVEL si el búfer DestinationString no se puede paginar. Normalmente, los autores de llamadas se ejecutan en IRQL = PASSIVE_LEVEL porque la mayoría de las demás rutinas rtlXxxString no se pueden llamar en IRQL > PASSIVE_LEVEL.

Requisitos

Consulte también

RtlInitAnsiString