Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

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


Feedback

Was this page helpful?

Additional resources