SysAllocString function

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

Syntax

BSTR SysAllocString(
  _In_opt_ const OLECHAR *psz
);

Parameters

psz [in, optional]

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