[ConvertINetString is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use MultiByteToWideChar or WideCharToMultiByte. ]
Performs character set conversion between a given source code page identifier and a destination code page identifier.
HRESULT ConvertINetString( LPDWORD lpdwMode, DWORD dwSrcEncoding, DWORD dwDstEncoding, LPCSTR lpSrcStr, LPINT lpnSrcSize, LPBYTE lpDstStr, LPINT lpnDstSize );
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.
A DWORD that contains the code page identifier value for the source string.
A DWORD that contains the code page identifier value for the destination string.
A pointer to the string that is being converted.
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.
A pointer to the string buffer where the conversion result is stored.
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.
The function returns one of the following values.
Performed the conversion successfully.
The specified conversion is not supported on the system.
An error has occurred.
An application calls this function to convert a character stream in an Internet character set to a Windows code page, or vice versa. This function provides a conversion similar to the conversion performed by calling IMultiLanguage::ConvertString.
Minimum supported client
Minimum supported server
|Windows 2000 Server|