|
IStorage::RenameElement
Renames the specified element in this storage object.
HRESULT RenameElement(
const wchar_t * pwcsOldName,
| //Points to the name of the element to be changed
| const wchar_t * pwcsNewName
| //Points to the new name for the specified element
| );
|
|
Parameters
pwcsOldName
[in]Points to the name of the element to be changed.
pwcsNewName
[in]Points to the new name for the specified element.
Return Values
S_OK
The element was successfully renamed.
STG_E_ACCESSDENIED
The caller does not have sufficient permissions for renaming the element.
STG_E_FILENOTFOUND
The element with the specified old name does not exist.
STG_E_FILEALREADYEXISTS
The element specified by the new name already exists.
STG_E_INSUFFICIENTMEMORY
The element was not renamed due to a lack of memory.
STG_E_INVALIDNAME
Invalid value for one of the names.
STG_E_INVALIDPOINTER
The pointer specified for the element was invalid.
STG_E_INVALIDPARAMETER
One of the parameters was invalid.
STG_E_REVERTED
The object has been invalidated by a revert operation above it in the
transaction tree.
STG_E_TOOMANYOPENFILES
The element was not renamed because there are too many open files.
Comments
An element in a storage object cannot be renamed while it is open. The rename
operation is subject to committing the changes if the storage is open in
transacted mode.
The IStorage::RenameElement method is not guaranteed to work in low memory with storage objects open in
transacted mode. It may work in direct mode.
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
