C++ Syntax

__int32

MKI_FileUnbufferedWriteAsAnsi(

HANDLE f_hFileHandle,

const LPCWSTR f_pszText );

__int32

MKI_FileUnbufferedWriteAsAnsi(

HANDLE f_hFileHandle,

const LPCWSTR f_pszText,

const size_t f_unLength );

Converts a UTF-16 string to Ansi and writes the Ansi data directly to a file opened for write access.

This procedure does not support the additional disk write cache, i.e. it may not be used after calling either MKI_FileWriteInitNull, MKI_FileWriteInitDisk or MKI_FileWriteInitMemory!

Parameters

FileHandle

[HANDLE] File handle of a file open for write access.

Text

[const LPCWSTR] Address of UTF-16 string to be converted to Ansi and then written to the file.

Length

[const size_t] Optional number of UTF-16 characters in the string to be converted to Ansi and then written to the file. Must not exceed the number of characters in Text!

Return Value

Returns the number of bytes written to the file. Based on the nature of the UTF-16 to Ansi conversion, the resulting number of bytes written is usually the same as the number of characters in the UTF-16 string (or Length).

If the return value is negative, an error has occurred (usually indicating that the drive is full).