Función JetRenameTable
Se aplica a: Windows | Windows Server
Función JetRenameTable
La función JetRenameTable se puede usar para cambiar el nombre de una tabla existente.
JET_ERR JET_API JetRenameTable(
__in JET_SESID sesid,
__in JET_DBID dbid,
__in const tchar* szName,
__in const tchar* szNameNew
);
Parámetros
sesid
La sesión que se va a usar para esta llamada.
dbid
Base de datos que se va a usar para esta llamada.
szName
Nombre actual de la tabla cuyo nombre se cambiará.
szNameNew
Nuevo nombre de la tabla cuyo nombre se cambiará.
Valor devuelto
Esta función devuelve el JET_ERR tipo de datos con uno de los siguientes códigos de retorno. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.
Código devuelto |
Descripción |
|---|---|
JET_errSuccess |
La operación se ha completado correctamente. |
JET_errClientRequestToStopJetService |
No es posible completar la operación porque toda la actividad de la instancia asociada a la sesión ha dejado de funcionar como resultado de una llamada a JetStopService. |
JET_errInstanceUnavailable |
No es posible completar la operación porque la instancia asociada a la sesión ha encontrado un error irrecuperable que requiere que se revoque el acceso a todos los datos para proteger la integridad de esos datos. Este error solo lo devolverá Windows XP y versiones posteriores. |
JET_errInvalidDatabase |
La base de datos especificada no era válida. Este error solo se devuelve en Windows 2000 cuando se intenta realizar una operación de cambio de nombre de tabla en la base de datos temporal. JET_errInvalidDatabaseId se devuelve para este caso en versiones posteriores. |
JET_errInvalidDatabaseId |
El identificador de base de datos especificado no era válido. |
JET_errInvalidName |
Uno de los nombres de objeto especificados no era válido. Todos los nombres de objeto deben cumplir el mismo conjunto de reglas. Estas reglas son:
|
JET_errInvalidParameter |
Uno de los parámetros proporcionados contenía un valor inesperado o contenía un valor que no tenía sentido cuando se combinaba con el valor de otro parámetro. Esto puede ocurrir para JetRenameTable cuando:
|
JET_errNotInitialized |
No es posible completar la operación porque la instancia asociada a la sesión aún no se ha inicializado. |
JET_errObjectNotFound |
Esta tabla especificada no existe para esta base de datos. |
JET_errRestoreInProgress |
No es posible completar la operación porque una operación de restauración está en curso en la instancia asociada a la sesión. |
JET_errSessionSharingViolation |
No se puede usar la misma sesión para más de un subproceso al mismo tiempo. Este error solo lo devolverá Windows XP y versiones posteriores. |
JET_errTermInProgress |
No es posible completar la operación porque la instancia asociada a la sesión se está cerrando. |
JET_errTransReadOnly |
No se puede realizar una actualización mientras se encuentra dentro del ámbito de una transacción de solo lectura. Una transacción de solo lectura es una transacción que se ha iniciado mediante una llamada a JetBeginTransaction2 con JET_bitTransactionReadOnly. Este error solo lo devolverá Windows XP y versiones posteriores. |
Si se ejecuta correctamente, el nombre de la tabla especificada en la base de datos determinada se cambia permanentemente al nuevo nombre.
Si se produce un error, no se producirá ningún cambio en el estado de la base de datos.
Requisitos
| Requisito | Value |
|---|---|
Cliente |
Requiere Windows Vista, Windows XP o Windows 2000 Professional. |
Servidor |
Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server. |
Encabezado |
Declarado en Esent.h. |
Library |
Use ESENT.lib. |
Archivo DLL |
Requiere ESENT.dll. |
Unicode |
Se implementa como JetRenameTableW (Unicode) y JetRenameTableA (ANSI). |