locale_to_character_buffer

template<class character>
bool locale_to_character_buffer(const character* source,
                                character* destination,
                                unsigned length)

This function converts from the locale (OEM) character set to the ANSI character set.

Parameters

const character* source

A pointer to a buffer containing the OEM characters to be converted.

character* destination

A pointer to a buffer to hold the converted string.

unsigned length

The length of the buffer specified by the previous parameter.

Return

bool

The function always returns true.

Notes

If the single byte version of this function is being used, the characters may be converted in place by ensuring that the source and destination pointers are the same.