SysAllocString.3w

Langue: en

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

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

SysAllocString (OLEAUT32.2)

SYNOPSIS

BSTR SysAllocString
 (
  LPCOLESTR str
 )

DESCRIPTION

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

Defined in "ole2disp.h".

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

Debug channel "ole".