NdisAnsiStringToUnicodeString (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.

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

Syntax


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

Parameters

DestinationString [in, out]

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

SourceString [in]

Pointer to the ANSI string to be converted.

Return value

NdisAnsiStringToUnicodeString 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 DestinationString must be at least twice the size of that at SourceString.

Requirements

Version

See NdisAnsiStringToUnicodeString.

Header

Ndis.h (include Ndis.h)

IRQL

PASSIVE_LEVEL

See also

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

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft