Compartir vía

SccRunScc (Función)

  • Artículo

Esta función invoca la herramienta de administración del control de código fuente.

Sintaxis

SCCRTN SccRunScc(
   LPVOID  pvContext,
   HWND    hWnd,
   LONG    nFiles,
   LPCSTR* lpFileNames
);

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 lpFileNames matriz.

lpFileNames

[in] Matriz de nombres de archivo seleccionados.

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 herramienta de administración del control de código fuente se invocó correctamente.
SCC_I_OPERATIONCANCELED La operación se canceló.
SCC_E_INITIALIZEFAILED No se pudo inicializar el sistema de 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_CONNECTIONFAILURE No se pudo conectar al sistema de control de código fuente.
SCC_E_FILENOTCONTROLLED El archivo seleccionado no está bajo control de código fuente.
SCC_E_NONSPECIFICERROR Error no específico.

Comentarios

Esta función permite al autor de la llamada acceder a toda la gama de características del sistema de control de código fuente a través de una herramienta de administración externa. Si el sistema de control de código fuente no tiene ninguna interfaz de usuario, el complemento de control de código fuente puede implementar una interfaz para realizar las funciones de administración necesarias.

Se llama a esta función con un recuento y una matriz de nombres de archivo para los archivos seleccionados actualmente. Si la herramienta de administración la admite, la lista de archivos se puede usar para preseleccionar archivos en la interfaz de administración; De lo contrario, se puede omitir la lista.

Normalmente, esta función se invoca cuando el usuario selecciona el servidor iniciar <control de> código fuente en el menú Archivo ->Control de código fuente. Esta opción de menú Inicio siempre se puede deshabilitar o incluso ocultar estableciendo una entrada del Registro. Consulte How to: Install a Source Control Plug-in (Cómo: Instalar un complemento de control de código fuente) para obtener más información. Solo se llama a esta función si SccInitialize devuelve el SCC_CAP_RUNSCC bit de funcionalidad (consulte Marcas de funcionalidad para obtener más información sobre este y otros bits de funcionalidad).

Consulte también