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

See also

String Manipulation Functions