SysStringLen (Windows CE 5.0)
This function retrieves the length of a string.
UINT SysStringLen(BSTRbstr );
Parameters
- bstr
[in] Unicode string that was allocated previously.
Return Values
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:
- If BSTR was allocated with SysAllocStringLen, SysReAllocStringLen, or SysAllocStringByteLen
- If the passed-in characters included a null character in the first cch characters
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 CE supports only Unicode strings.
Passing invalid (and under some circumstances NULL) pointers to this function causes an unexpected termination of the application.
Requirements
OS Versions: Windows CE 2.0 and later.
Header: Oleauto.h.
Link Library: Oleaut32.lib.
See Also
Automation Functions | BSTR | SysAllocStringLen | SysReAllocStringLen | SysAllocStringByteLen
Send Feedback on this topic to the authors