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.