SysAllocStringByteLen.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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

Defined in "oleauto.h".

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

Debug channel "ole".