Método IStorage::RenameElement (objidl.h)
El método RenameElement cambia el nombre del substorage o secuencia especificados en este objeto de almacenamiento.
Sintaxis
HRESULT RenameElement(
[in] const OLECHAR *pwcsOldName,
[in] const OLECHAR *pwcsNewName
);
Parámetros
[in] pwcsOldName
Puntero a una cadena Unicode terminada en null de caracteres anchos que contiene el nombre del substorage o la secuencia que se va a cambiar.
[in] pwcsNewName
Puntero a una cadena unicode terminada en null de caracteres anchos que contiene el nuevo nombre para el substorage o secuencia especificados.
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
| S_OK | Se ha cambiado el nombre del elemento correctamente. |
| E_PENDING | Solo almacenamiento asincrónico: la parte o todos los datos del elemento no están disponibles actualmente. |
| STG_E_ACCESSDENIED | El autor de la llamada no tiene permisos suficientes para cambiar el nombre del elemento. |
| STG_E_FILENOTFOUND | El elemento con el nombre anterior especificado no existe. |
| STG_E_FILEALREADYEXISTS | El elemento especificado por el nuevo nombre ya existe. |
| STG_E_INSUFFICIENTMEMORY | No se cambió el nombre del elemento debido a una falta de memoria. |
| STG_E_INVALIDNAME | Valor no válido para uno de los nombres. |
| STG_E_INVALIDPOINTER | El puntero especificado para el elemento no era válido. |
| STG_E_INVALIDPARAMETER | Uno de los parámetros no era válido. |
| STG_E_REVERTED | Una operación de reversión por encima de él ha invalidado el objeto de almacenamiento en el árbol de transacciones. |
| STG_E_TOOMANYOPENFILES | No se ha cambiado el nombre del elemento porque hay demasiados archivos abiertos. |
Comentarios
IStorage::RenameElement cambia el nombre del substorage o secuencia especificados en este objeto de almacenamiento. No se puede cambiar el nombre de un elemento de un objeto de almacenamiento mientras está abierto. La operación de cambio de nombre está sujeta a confirmar los cambios si el almacenamiento está abierto en modo de transacción.
No se garantiza que el método IStorage::RenameElement funcione en poca memoria con objetos de almacenamiento abiertos en modo de transacción. Puede funcionar en modo directo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | objidl.h |
| Library | Uuid.lib |
| Archivo DLL | Ole32.dll |