SysStringByteLen
A version of this page is also available for
4/8/2010
This function retrieves the length (in bytes) of a string.
Syntax
HRESULT SysStringByteLen(
BSTR bstr
);
Parameters
- bstr
[in] Unicode string that was previously allocated.It cannot be NULL.
Return Value
Returns an HRESULT value.
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 len characters
For a BSTR allocated with SysAllocStringLen, SysReAllocStringLen, or SysAllocStringByteLen, this function always retrieves the number of bytes specified in the len parameter at allocation time.
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