SysAllocString(3w)

SysAllocString3w

Usage

BSTR SysAllocString
(
LPCOLESTR str
)

Overview

Create a BSTR from an OLESTR.

Params

str [In] Source to create BSTR from.

Returns

Success: A BSTR allocated with SysAllocStringLen(3w).

Failure: NULL, if oleStr is NULL.

Notes

See BSTR(3w). MSDN (October 2001) incorrectly states that NULL is returned if oleStr has a length of 0. Native Win32 and this implementation both return a valid empty BSTR in this case.

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.