NdisUnicodeStringToAnsiString

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

NDIS_STATUS
  NdisUnicodeStringToAnsiString(
    IN OUT PANSI_STRING  DestinationString,
    IN PUNICODE_STRING  SourceString
    );

Parameters

DestinationString

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

SourceString

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.

Headers

Declared in Ndis.h. Include Ndis.h.

Comments

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.

Callers of NdisUnicodeStringToAnsiString run at IRQL = PASSIVE_LEVEL.

See Also

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