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
Target platform |
Universal |
Version |
See NdisAnsiStringToUnicodeString. |
Header |
Ndis.h (include Ndis.h) |
Library |
Ndis.lib |
IRQL |
PASSIVE_LEVEL |
See also
DriverEntry of NDIS Protocol Drivers