RtlInitAnsiString

The RtlInitAnsiString routine initializes a counted ANSI string.

VOID 
  RtlInitAnsiString(
    IN OUT PANSI_STRING  DestinationString,
    IN PCSZ  SourceString
    );

Parameters

DestinationString

Pointer to the ANSI_STRING structure to be initialized.

SourceString

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

Return Value

None

Headers

Declared in wdm.h and ntddk.h. Include wdm.h or ntddk.h.

Comments

The Buffer member of DestinationString is initialized to point to the SourceString. The length and maximum length for the DestinationString are initialized to the length of the SourceString. If SourceString is NULL, the lengths are zero.

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

See Also

RtlInitString, RtlInitUnicodeString, ANSI_STRING