NAME¶

SysAllocStringByteLen (OLEAUT32.150)

SYNOPSIS¶

BSTR SysAllocStringByteLen
(
LPCSTR str,
UINT len
)

DESCRIPTION¶

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".