SysStringLen

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function retrieves the length of a string.

Syntax

UINT SysStringLen(
  BSTR bstr 
); 

Parameters

  • bstr
    [in] Unicode string that was allocated previously.

Return Value

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

If the bstr parameter is null, zero is returned.

Remarks

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.

Requirements

Header oleauto.h
Library oleaut32.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Automation Functions
BSTR
SysAllocStringLen
SysReAllocStringLen
SysAllocStringByteLen