Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.


Windows Mobile 6.5
A version of this page is also available for

This function retrieves the length of a string.

UINT SysStringLen(
  BSTR bstr 


[in] Unicode string that was allocated previously.

The number of characters in bstr, not including a terminating null character, indicates success.

If the bstr parameter is null, zero is returned.

The returned value can be different from _fstrlen(bstr) if the following occurred:

For a BSTR allocated with SysAllocStringLen, SysAllocStringLen, or SysAllocStringByteLen, the SysStringLen function retrieves the number of characters specified in the cch parameter at allocation time.

Windows Embedded CE and Windows Mobile only support Unicode strings.

Passing invalid (and under some circumstances NULL) pointers to this function causes an unexpected termination of the application.

Windows Embedded CEWindows CE 2.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

© 2015 Microsoft