Performs character set conversion between a given source code page identifier and a destination code page identifier.
Syntax
HRESULT ConvertINetString(
LPDWORD lpdwMode,
DWORD dwSrcEncoding,
DWORD dwDstEncoding,
LPCSTR lpSrcStr,
LPINT lpnSrcSize,
LPBYTE lpDstStr,
LPINT lpnDstSize
);
Parameters
- lpdwMode
-
A pointer to a DWORD that is used internally to store conversion context. A caller should provide storage that is initialized with zero at the first call to the function. A caller must not modify the value without calling MLANG service functions.
- dwSrcEncoding
-
A DWORD that contains the code page identifier value for the source string.
- dwDstEncoding
-
A DWORD that contains the code page identifier value for the destination string.
- lpSrcStr
-
A pointer to the string that is being converted.
- lpnSrcSize
-
A pointer to the buffer that stores the length of the source string in bytes. If this is NULL, or if the length specified is -1, the function assumes that the source string is null-terminated. When the conversion is successful, the function returns the number of bytes processed to this buffer.
- lpDstStr
-
A pointer to the string buffer where the conversion result is stored.
- lpnDstSize
-
A pointer to the buffer that stores the length of the destination string in bytes. When the conversion is successful, the function returns the number of bytes copied to the lpDstStr buffer.
Return Value
The function returns one of the following values.
| S_OK | Performed the conversion successfully. |
| S_FALSE | The specified conversion is not supported on the system. |
| E_FAIL | An error has occurred. |
Remarks
An application calls this function to convert a character stream in an Internet character set to a Microsoft Windows code page, or vice versa.
This function provides a conversion similar to the conversion perfomed by calling IMultiLanguage::ConvertString.
Function Information
| Stock Implementation | mlang.dll |
|---|
| Custom Implementation | No |
|---|
| Import library | None |
|---|
| Minimum availability | Internet Explorer
5.5 |
|---|
| Minimum operating systems |
Windows 95, Windows NT 4.0, Windows CE 4.0 |
|---|