Función SccCheckin
Esta función comprueba los archivos desprotegido previamente en el sistema de control de código fuente, almacenando los cambios y creando una nueva versión. Se llama a esta función con un recuento y una matriz de nombres de los archivos que se van a comprobar.
Sintaxis
SCCRTN SccCheckin (
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPSTR* lpFileNames,
LPCSTR lpComment,
LONG fOptions,
LPCMDOPTS pvOptions
);
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 SCC puede usar como elemento primario para los cuadros de diálogo que proporciona.
nFiles
[in] Número de archivos seleccionados para que se protejan.
lpFileNames
[in] Matriz de nombres de ruta de acceso local completos de los archivos que se van a comprobar.
lpComment
[in] Comentario que se aplicará a cada uno de los archivos seleccionados que se van a comprobar. Este parámetro es NULL si el complemento de control de código fuente debe solicitar un comentario.
fOptions
[in] Marcas de comandos, ya sea 0 o SCC_KEEP_CHECKEDOUT.
pvOptions
[in] Opciones específicas del complemento SCC.
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 | El archivo se ha protegido correctamente. |
| SCC_E_FILENOTCONTROLLED | El archivo seleccionado no está bajo el 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. Se recomienda un reintento. |
| SCC_E_NONSPECIFICERROR | Error no específico. El archivo no estaba protegido. |
| SCC_E_NOTCHECKEDOUT | El usuario no ha desprotegido el archivo, por lo que no puede protegerlo. |
| SCC_E_CHECKINCONFLICT | No se pudo realizar la comprobación porque: - Otro usuario ha protegido con antelación y bAutoReconcile era false.o bien - No se puede realizar la combinación automática (por ejemplo, cuando los archivos son binarios). |
| SCC_E_VERIFYMERGE | El archivo se ha combinado automáticamente, pero no se ha protegido en la comprobación del usuario pendiente. |
| SCC_E_FIXMERGE | El archivo se ha combinado automáticamente, pero no se ha protegido debido a un conflicto de combinación que se debe resolver manualmente. |
| SCC_E_NOTAUTHORIZED | No se permite al usuario realizar esta operación. |
| SCC_I_OPERATIONCANCELED | La operación se canceló antes de la finalización. |
| SCC_I_RELOADFILE | Es necesario volver a cargar un archivo o proyecto. |
| SCC_E_FILENOTEXIST | No se encontró el archivo local. |
Comentarios
El comentario se aplica a todos los archivos que se están protegiéndose. El argumento comment puede ser una null cadena, en cuyo caso el complemento de control de código fuente puede solicitar al usuario una cadena de comentario para cada archivo.
El fOptions argumento puede tener un valor de la SCC_KEEP_CHECKEDOUT marca para indicar la intención del usuario de comprobar el archivo y volver a desprotegerlo.