NdisUnicodeStringToAnsiString (NDIS 5.1) function

Note   NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

NdisUnicodeStringToAnsiString 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]

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

SourceString [in]

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

See NdisUnicodeStringToAnsiString.

Header

Ndis.h (include Ndis.h)

IRQL

PASSIVE_LEVEL

See also

ANSI_STRING
DriverEntry of NDIS Protocol Drivers
MiniportInitialize
NdisAnsiStringToUnicodeString
NdisInitAnsiString
NdisInitializeString
NdisInitUnicodeString
ProtocolBindAdapter
UNICODE_STRING

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft