9.5.9 OleRename

OLESTATUS OleRename(lpObject, lpszNewname)

LPOLEOBJECT lpObject;

LPCSTR lpszNewname;

The OleRename function renames an object.

Parameter Description

lpObject Points to the object that is being renamed.
lpszNewname Points to a null-terminated string specifying the new name of the object.

Object names need not be seen by the user. They must be unique within the containing document and must be preserved when the document is saved.

The return value is OLE_OK if successful; otherwise, it could be one of the following:

OLE_ERROR_OBJECT

OLE_ERROR_NAME.

See AlsoOleQueryName