Click or drag to resize

Ansi2OemBuff Function

X#
Convert a specified number of ANSI characters in a source buffer to a buffer of corresponding OEM characters.

Namespace:  XSharp.RT
Assembly:  XSharp.RT (in XSharp.RT.dll) Version: 2.19
Syntax
 FUNCTION Ansi2OemBuff(
	pszTarget AS PSZ,
	pszSource AS PSZ,
	dwCount AS DWORD
) AS PSZ
Request Example View Source

Parameters

pszTarget
Type: Psz
A pointer to the buffer that will contain the converted string.
pszSource
Type: Psz
A pointer to the buffer that contains the string to convert.
dwCount
Type: DWord
The number of characters to convert.

Return Value

Type: Psz
A pointer to the buffer that contains the converted string.
Remarks
Ansi2OemBuff() is similar to Ansi2Oem(), except that the resulting string is stored in the buffer pointed to by pszTarget.
Also, the dwCount argument lets you specify the number of characters to be converted.
Tip Tip
You are responsible for allocating space for the buffer pointed to by pszTarget.
Using an unallocated buffer pointer can have adverse results.
Remarks
Tip Tip
The PSZ type is included in the X# language and runtime for compatibility only. In most cases the type can and should be replaced with normal strings.
If you need to interface with Win32 API functions that expect an ansi string, there is often also an alternative with a unicode string. We recommend to use that alternative when possible.
Examples
This example uses Ansi2OemBuff() to convert the contents of the ANSI string "ßä" to the OEM character set. Note that the source string is also used as a target string:
X#
1LOCAL cStr := "ßä"
2Ansi2OemBuff(PSZ(_CAST, cStr), PSZ(_CAST, cStr), SLen(cStr))
See Also