Microsoft HomeproductssearchsupportshopWrite Us   Microsoft Home
Magazine
 |  Community
 |  Workshop
 |  Tools & Samples
 |  Training
 |  Site Info

Workshop

IMultiLanguage::ConvertStringToUnicode Method


Translates the source string from the specified code page to Unicode.

Syntax

HRESULT ConvertStringToUnicode(
    DWORD *pdwMode,
    DWORD dwEncoding,
    CHAR *pSrcStr,
    UINT *pcSrcSize,
    WCHAR *pDstStr,
    UINT *pcDstSize
);

Parameters

pdwMode
[in, out] Storage for conversion context. A calling function should only provide storage that is initialized with zero at the first call to the method. The caller should not modify the value.
dwEncoding
[in] Code page identifier value for the source multibyte string. This value is equivalent to the uiCodePage member of the MIMECPINFO structure assigned to dwEncoding.
pSrcStr
[in] Address of the multibyte string that is to be converted.
pcSrcSize
[in, out] Address of the buffer that stores the length of the source string, in byte counts. If this is NULL, or if the length specified is -1, the API assumes pSrcStr is null-terminated. When 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 memory allocated for pDstStr, in character counts. When conversion is successful, the method returns the number of characters copied to pDstStr to this buffer.

Return Value

Returns one of the following values:

S_OK Success.
S_FALSE The conversion specified is not supported on the system.
E_FAIL An error occurred.

Remarks

Note that the size of the multibyte string to be converted is specified with a byte count, while the size of the Unicode string returned is given in characters.

See Also

IMLangConvertCharset, IMultiLanguage, IMultiLanguage2, IMultiLanguage2::ConvertStringFromUnicodeEx, IMultiLanguage2::ConvertStringInIStream, IMultiLanguage2::ConvertStringToUnicodeEx


Does this content meet your programming needs? Write us!

Back to topBack to top

© 1998 Microsoft Corporation. All rights reserved. Terms of use.

 

Magazine Home
Ask Jane
DHTML Dude
Extreme XML
For Starters
More or Hess
Servin' It Up
Site Lights
Web Men Talking
Member Community Home
Benefits: Freebies & Discounts
Benefits: Promote Your Site
Benefits: Connect with Your Peers
Benefits at a Glance
Online Special-Interest Groups
Your Membership
SBN Stores
Join Now
Workshop Home
Essentials
Content & Component Delivery
Component Development
Data Access & Databases
Design
DHTML, HTML & CSS
Extensible Markup Language (XML)
Languages & Development Tools
Messaging & Collaboration
Networking, Protocols & Data Formats
Reusing Browser Technology
Security & Cryptography
Server Technologies
Streaming & Interactive Media
Web Content Management
Workshop Index
Tools & Samples Home
Tools
Samples, Headers, Libs
Images
Sounds
Style Sheets
Web Fonts
Training Home
SBN Live Seminars
SBN Live Chats
Courses
Peer Support
CD-ROM Training
Books & Training Kits
Certification
SBN Home
New to SBN?
What's New on SBN
Site Map
Site Search
Glossary
Write Us
About This Site