SysAllocString function

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

Syntax

BSTR SysAllocString(
  const OLECHAR *psz
);

Parameters

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

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

See also

String Manipulation Functions