SysAllocString function (oleauto.h)

Allocates a new string and copies the passed string into it.

Syntax

BSTR SysAllocString(
  [in, optional] const OLECHAR *psz
);

Parameters

[in, optional] psz

The string to copy.

Return value

If successful, returns the string. If psz is a zero-length string, returns a zero-length BSTR. If psz is NULL or insufficient memory exists, returns NULL.

Remarks

You can free strings created with SysAllocString using SysFreeString.

Requirements

Requirement Value
Target Platform Windows
Header oleauto.h
Library OleAut32.lib
DLL OleAut32.dll

See also

String Manipulation Functions