SysAllocStringByteLen(3w)

SysAllocStringByteLen3w

Usage

BSTR SysAllocStringByteLen
(
LPCSTR str,
UINT len
)

Overview

Create a BSTR from an OLESTR of a given byte length.

Params

str [In] Source to create BSTR from.

len [In] Length of oleStr in bytes.

Returns

Success: A newly allocated BSTR

Failure: NULL, if len is >= 0x80000000, or memory allocation fails.

Notes

-If len is 0 or oleStr is NULL the resulting string is empty ("").

-This function always NUL terminates the resulting BSTR.

-oleStr may be either an LPCSTR or LPCOLESTR, since it is copied without checking for a terminating NUL. See BSTR(3w).

Implementation

Declared in "oleauto.h".

Implemented in "dlls/oleaut32/oleaut.c".

Debug channel "ole".

Releases

4 releases since Debian 4.0 (Etch); the text changed 3 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7

From libwine-dev 1.4.1-4 in Debian 7 (Wheezy). Parsed by carta from the page's man source.