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