Renames a member in an OLE storage. The member can be another OLE object (a substorage) or a stream.
OLEStorage objects
olestorage.MemberRename ( membername, newname )
Argument |
Description |
|---|---|
olestorage |
The name of an object variable of type OLEStorage containing the member (substorage or stream) you want to rename |
membername |
A string whose value is the name of the member you want to rename |
newname |
A string whose value is the new name to be assigned to the member |
Integer. Returns 0 if it succeeds and one of the following negative values if an error occurs:
-1 The storage is not open
-2 Member not found
-3 Insufficient resources or too many files open
-4 Access denied
-5 Invalid storage state
-6 Duplicate name
-9 Other error
If any argument’s value is null, MemberRename returns null.
This example creates a storage object and opens an OLE object in a file. It checks whether wordobj is a substorage within that object, and if so renames it to memo and saves the object back to the file:
boolean lb_memexists
integer result
stg_stuff = CREATE OLEStorage
stg_stuff.Open("c:\ole2\mystuff.ole")
stg_stuff.MemberExists("wordobj", lb_memexists)
IF lb_memexists THEN
result = &
stg_stuff.MemberRename("wordobj", "memo")
IF result = 0 THEN stg_stuff.Save()
END IF
