SccRename (Función)
Esta función cambia el nombre de un archivo en el sistema de control de código fuente.
Sintaxis
SCCRTN SccRename(
LPVOID pvContext,
HWND hWnd,
LPCSTR lpFileName,
LPCSTR lpNewName
);
Parámetros
pvContext
[in] Estructura del contexto del complemento de control de código fuente.
hWnd
[in] Identificador de la ventana del IDE que el complemento de control de código fuente puede usar como elemento primario para los cuadros de diálogo que proporciona.
lpFileName
[in] Nombre de archivo completo del archivo al que se va a cambiar el nombre.
lpNewName
[in] Nombre nuevo completo. Si la ruta de acceso del directorio es diferente, el archivo se ha movido de un subdirectorio a otro.
Valor devuelto
Se espera que la implementación del complemento de control de código fuente de esta función devuelva uno de los siguientes valores:
| Value | Descripción |
|---|---|
| SCC_OK | La operación de cambio de nombre se completó correctamente. |
| SCC_E_PROJNOTOPEN | El proyecto no está abierto bajo el control de código fuente. |
| SCC_E_FILENOTCONTROLLED | El archivo no está bajo control de código fuente. |
| SCC_E_ACCESSFAILURE | Se produjo un problema al acceder al sistema de control de código fuente, probablemente debido a problemas de red o contención. |
| SCC_E_NOTAUTHORIZED | El usuario no está autorizado para completar esta operación. |
| SCC_E_COULDNOTCREATEPROJECT | No se pudo crear el proyecto como parte del proceso de cambio de nombre. |
| SCC_E_OPNOTPERFORMED | No se realizó la operación. |
| SCC_E_NONSPECIFICERROR | Error no especificado o general. |
Comentarios
Esta función se puede usar para cambiar el nombre de un archivo o moverlo de una ubicación a otra en el sistema de control de código fuente. El complemento de control de código fuente no debe intentar acceder al archivo en el disco. Es responsabilidad del IDE cambiar el nombre del archivo local.