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