NdisAnsiStringToUnicodeString

This function converts a specified counted ASCII string into a counted Unicode string. The translation conforms to the current system locale information.

At a Glance

Header file: Ndis.h
Windows CE versions: 2.0 and later

Syntax

NDIS_STATUS NdisAnsiStringToUnicodeString(
IN OUT PNDIS_STRING
DestinationString,
IN PNDIS_ANSI_STRING
SourceString );

Parameters

DestinationString
Pointer to a caller-allocated buffer in which this function returns the converted Unicode string.
SourceString
Pointer to the ASCII string to be converted.

Return Values

NDIS_STATUS_SUCCESS indicates success. 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.

A driver that calls this function runs at IRQL PASSIVE_LEVEL.

See Also

NdisFreeString, NdisInitAnsiString, NdisInitializeString, NdisInitUnicodeString, NdisUnicodeStringToAnsiString