Función RtlInitStringEx (wdm.h)

La rutina RtlInitStringEx inicializa una cadena contada 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 como idéntica a la estructura ANSI_STRING .

[in, optional] 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

Esta rutina inicializa una cadena de caracteres contado.

La rutina copia el valor del puntero SourceString al miembro Buffer de la estructura 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.

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

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 10.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	vea la sección Comentarios.

Consulte también

ANSI_STRING