Compartir vía

SccHistory (Función)

  • Artículo

Esta función muestra el historial de los archivos especificados.

Sintaxis

SCCRTN SccHistory(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   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 de control de código fuente puede usar como elemento primario para los cuadros de diálogo que proporciona.

nFiles

[in] Número de archivos especificados en la lpFileName matriz.

lpFileName

[in] Matriz de nombres completos de archivos.

fOptions

[in] Marcas de comandos (actualmente no se usan).

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 historial de versiones se obtuvo correctamente.
SCC_I_RELOADFILE El sistema de control de código fuente modificó realmente el archivo en el disco al capturar el historial (por ejemplo, al obtener una versión anterior de él), por lo que el IDE debe volver a cargar este archivo.
SCC_E_FILENOTCONTROLLED El archivo no está bajo control de código fuente.
SCC_E_OPNOTSUPPORTED El sistema de control de código fuente no admite esta operación.
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_PROJNOTOPEN No se ha abierto el proyecto.
SCC_E_NONSPECIFICERROR Error no específico. No se pudo obtener el historial de archivos.

Comentarios

El complemento de control de código fuente puede mostrar su propio cuadro de diálogo para mostrar el historial de cada archivo, utilizando hWnd como ventana principal. Como alternativa, se puede usar la función de devolución de llamada de salida de texto opcional proporcionada al SccOpenProject , si se admite.

Tenga en cuenta que, en determinadas circunstancias, el archivo que se está examinando puede cambiar durante la ejecución de esta llamada. Por ejemplo, el comando Visual Source Caja fuerte history ofrece al usuario la oportunidad de obtener una versión anterior del archivo. En tal caso, el complemento de control de código fuente vuelve SCC_I_RELOAD a advertir al IDE que necesita volver a cargar el archivo.

Nota:

Si el complemento de control de código fuente no admite esta función para una matriz de archivos, solo se puede mostrar el historial de archivos del primer archivo.

Consulte también