SccRename (Función)

Artículo
01/13/2024

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.

Consulte también

Funciones de API de complemento de control de código fuente

Compartir vía