Función SccDirDiff
Esta función muestra las diferencias entre el directorio local actual en el disco cliente y el proyecto correspondiente bajo el control de código fuente.
Sintaxis
SCCRTN SccDirDiff(
LPVOID pContext,
HWND hWnd,
LPCSTR lpDirName,
LONG dwFlags,
LPCMDOPTS pvOptions
);
Parámetros
pContext
[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.
lpDirName
[in] Ruta de acceso completa al directorio local para el que mostrar una diferencia visual.
dwFlags
[in] Marcas de comandos (consulte la sección Comentarios).
pvOptions
[in] Opciones específicas del complemento de control de código fuente.
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 directorio del disco es el mismo que el proyecto en el control de código fuente. |
| SCC_I_FILESDIFFER | El directorio del disco es diferente del proyecto en el control de código fuente. |
| SCC_I_RELOADFILE | Es necesario volver a cargar un archivo o proyecto. |
| SCC_E_FILENOTCONTROLLED | El directorio no está bajo el control de código fuente. |
| SCC_E_NOTAUTHORIZED | No se permite al usuario realizar esta operación. |
| 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 SCC_E_UNKNOWNERROR |
Error no específico. |
| SCC_E_FILENOTEXIST | No se encontró el directorio local. |
Comentarios
Esta función se usa para indicar al complemento de control de código fuente que muestre al usuario una lista de cambios en un directorio especificado. El complemento abre su propia ventana, en un formato de su elección, para mostrar las diferencias entre el directorio del usuario en el disco y el proyecto correspondiente bajo el control de versiones.
Si un complemento admite la comparación de directorios en absoluto, debe admitir la comparación de directorios en función de un nombre de archivo, incluso si no se admiten las opciones de "diferencias rápidas".
dwFlags |
Interpretación |
|---|---|
| SCC_DIFF_IGNORECASE | Comparación sin distinción entre mayúsculas y minúsculas (se puede usar para diferencias rápidas o visuales). |
| SCC_DIFF_IGNORESPACE | Omite el espacio en blanco (puede usarse para diferencias rápidas o visuales). |
| SCC_DIFF_QD_CONTENTS | Si es compatible con el complemento de control de código fuente, compara de forma silenciosa el directorio byte byte. |
| SCC_DIFF_QD_CHECKSUM | Si es compatible con el complemento, compara silenciosamente el directorio a través de una suma de comprobación o, si no se admite, vuelve a SCC_DIFF_QD_CONTENTS. |
| SCC_DIFF_QD_TIME | Si es compatible con el complemento, compara silenciosamente el directorio a través de su marca de tiempo o, si no se admite, retroceda en SCC_DIFF_QD_CHECKSUM o SCC_DIFF_QD_CONTENTS. |
Nota:
Esta función usa las mismas marcas de comandos que el SccDiff. Sin embargo, un complemento de control de código fuente puede optar por no admitir la operación de "diferencia rápida" para los directorios.