NdisUnicodeStringToAnsiString function

The NdisUnicodeStringToAnsiString function converts a given counted Unicode string into a counted ANSI string. The translation conforms to the current system locale information.

Syntax


NDIS_STATUS NdisUnicodeStringToAnsiString(
  _Inout_  PANSI_STRING DestinationString,
  _In_     PUNICODE_STRING SourceString
);

Parameters

DestinationString [in, out]

A pointer to a caller-allocated buffer in which this function should return the converted ANSI string.

SourceString [in]

A pointer to the Unicode string to be converted.

Return value

NdisUnicodeStringToAnsiString returns NDIS_STATUS_SUCCESS if the conversion succeeds. Otherwise, the contents of the buffer at DestinationString are unaffected.

Remarks

The caller must allocate storage for both the source and destination strings and release these buffers as soon as the strings are no longer needed. The buffer at SourceString must be at least twice the size of that at DestinationString .

Requirements

Version

Supported for existing drivers in NDIS 6.0 and later, but new drivers should use RtlUnicodeStringToAnsiString instead.

Header

Ndis.h (include Ndis.h)

IRQL

PASSIVE_LEVEL

DDI compliance rules

Irql_Miscellaneous_Function

See also

ANSI_STRING
DriverEntry of NDIS Protocol Drivers
MiniportInitializeEx
RtlAnsiStringToUnicodeString
RtlInitUnicodeString
ProtocolBindAdapterEx
UNICODE_STRING

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft