9.4.2 OleCopyFromLink

OLESTATUS OleCopyFromLink(lpObject, lpszProtocol, lpClient, lhClientDoc,

lpszObjname, lplpObject)

LPOLEOBJECT lpObject;

LPCSTR lpszProtocol;

LPOLECLIENT lpClient;

LHCLIENTDOC lhClientDoc;

LPCSTR lpszObjname;

LPOLEOBJECT FAR * lplpObject;

The OleCopyFromLink function makes an embedded copy of a linked object.

Parameter Description

lpObject Points to the linked object that is to be embedded.
lpszProtocol Points to a null-terminated string specifying the name of the protocol required for the new embedded object. Currently this value can be "StdFileEditing" (the name of the OLE protocol).
lpClient Points to an OLECLIENT structure for the new object.
lhClientDoc Identifies the client document in which the object is to be created.
lpszObjname Points to a null-terminated string specifying the client's name for the object.
lplpObject Points to a variable where the client DLL will store the long pointer to the new object.

Making an embedded copy of a linked object may involve starting the server application.

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

OLE_BUSY
OLE_ERROR_HANDLE
OLE_ERROR_NAME
OLE_ERROR_OBJECT
OLE_ERROR_PROTOCOL
OLE_WAIT_FOR_RELEASE

See AlsoOleObjectConvert