Syntax 3: For saving an OLE control to an OLE storage
Description
Saves the object in an OLE control to an OLE storage object in
memory.
Applies to
OLE controls
Syntax
|
1 |
olecontrol.SaveAs ( targetstorage, substoragename ) |
|
Argument |
Description |
|---|---|
|
olecontrol |
The name of the OLE control containing the object you |
|
targetstorage |
The name of an object variable of OLEStorage in which to |
|
substoragename |
A string whose value is the name of a substorage within |
Return value
Integer.
Returns 0 if it succeeds and one of the following negative values
if an error occurs:
-1 — The control is empty
-2 — The storage is not open
-3 — The storage name is invalid
-9 — Other error
If any argument’s value is null, SaveAs returns null.
Usage
The Open function establishes a connection between a storage file
and a storage object, or a storage file or object and an OLE control.
The Save function uses this connection to save the OLE data.
When you call SaveAs for an OLE control, it closes the current
connection between the OLE object and its storage, either file or
storage object. It establishes a new connection with the new storage,
which will be the target of subsequent calls to the Save
function.
Examples
This example saves the object in the control ole_1 in the storage
variable stg_stuff:
|
1 2 |
integer result result = ole_1.SaveAs(stg_stuff) |
See also