SysStringByteLen

HRESULT SysStringByteLen( 
  BSTR  bstr  
);
 

Returns the length (in bytes) of a BSTR. Valid for 32-bit systems only.

Parameter

bstr

A BSTR allocated previously. It cannot be Null.

Return Value

The number of bytes in bstr, not including a terminating null character.

Comments

The returned value may be different from fstrlen(bstr) if the BSTR was allocated with Sys[Re]AllocStringLen or SysAllocStringByteLen, and the passed-in characters included a null character in the first len characters. For a BSTR allocated with Sys[Re]AllocStringLen or SysAllocStringByteLen, this function always returns the number of bytes specified in the len parameter at allocation time.

Example

// Display the status message.

TextOut(
    hdc,
    rcMsg.left + (m_dxFont / 2),
    rcMsg.top + ((rcMsg.bottom - rcMsg.top - m_dyFont) / 2),
    m_bstrMsg, SysStringByteLen(m_bstrMsg));

QuickInfo

  Windows NT: Use version 3.1 and later.
  Windows: Use Windows 95 and later.
  Header: Declared in oleauto.h.
  Import Library: Link with oleaut32.lib.