RtlInitString

VOID
    RtlInitString(
        IN OUT PSTRING  DestinationString,
        IN PCSZ  SourceString
        );

RtlInitString initializes a counted string.

Parameters

DestinationString

Points to the buffer for a counted string to be initialized.

SourceString

Points to a zero-terminated string value with which to initialize the counted string.

Comments

DestinationString is initialized to point to SourceString and the length and maximum length for the DestinationString are initialized to the length of SourceString. The lengths are is zero if SourceString is NULL.

Callers of RtlInitString can be running at IRQL <= DISPATCH_LEVEL if the DestinationString buffer is nonpageable. Usually, callers run at IRQL PASSIVE_LEVEL because most other Rtl..String routines cannot be called at raised IRQL.

See Also

RtlInitAnsiString, RtlInitUnicodeString