IMultiLanguage2::ConvertString (Windows CE 5.0)
This method converts the given source string from the source code page to the destination code page.
HRESULTConvertString(DWORD* pdwMode,DWORDdwSrcEncoding,DWORDdwDstEncoding,BYTE* pSrcStr,UINT* pcSrcSize,BYTE* pDstStr,UINT* pcDstSize);
Parameters
- pdwMode
[in, out] Address of storage for conversion context. The calling function should only provide storage that is initialized with zero at the first call to the method. The caller should not modify this value. - dwSrcEncoding
[in] Specifies the code page identifier value for the source string. This value is equivalent to the uiCodePage member of the MIMECPINFO structure assigned to the dwSrcEncoding parameter. - dwDstEncoding
[in] Specifies the code page identifier value for the destination string. This value is equivalent to the uiCodePage member of the MIMECPINFO structure assigned to the dwDstEncoding parameter. - pSrcStr
[in] Address of the string that is being converted. - pcSrcSize
[in, out] Address of the buffer that stores the length of the source string, in bytes. If this is NULL, or if the length specified is -1, the method assumes the string pointed to by the pSrcStr parameter is null-terminated. When the conversion is successful, the method returns the number of bytes processed to this buffer. - pDstStr
[in] Address of the string buffer where the conversion result is stored. - pcDstSize
[in, out] Address of the buffer that stores the length of the string pointed to by the pDstStr parameter, in bytes. When the conversion is successful, the method returns to this buffer the number of bytes copied to the string.
Return Values
The following table shows the possible return values for this method.
| Value | Description |
|---|---|
| S_OK | Success. |
| S_FALSE | The specified conversion is not supported on the system. |
| E_FAIL | An error occurred. |
Remarks
This method takes a pointer to a BYTE array for both the source and destination string buffers. The size of this buffer is handled as the number of bytes for both the inbound and outbound parameters.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Mlang.h, Mlang.idl.
Link Library: Mlang.dll.
Send Feedback on this topic to the authors