Función SccAdd

Artículo
01/13/2024

Esta función agrega nuevos archivos al sistema de control de código fuente.

Sintaxis

SCCRTN SccAdd(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LPCSTR    lpComment,
   LONG*     pfOptions,
   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 seleccionados para agregarse al proyecto actual tal como se indica en la lpFileNames matriz.

lpFileNames

[in] Matriz de nombres locales completos de archivos que se van a agregar.

lpComment

[in] Comentario que se va a aplicar a todos los archivos que se van a agregar.

pfOptions

[in] Matriz de marcas de comandos, proporcionadas por archivo.

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	La operación add se realizó correctamente.
SCC_E_FILEALREADYEXISTS	El archivo seleccionado ya está bajo control de código fuente.
SCC_E_TYPENOTSUPPORTED	El sistema de control de código fuente no admite el tipo de archivo (por ejemplo, binario).
SCC_E_OPNOTSUPPORTED	El sistema de control de código fuente no admite 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_NOTAUTHORIZED	No se permite al usuario realizar esta operación.
SCC_E_NONSPECIFICERROR	Error no específico; agregar no realizado.
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 habitual fOptions se reemplaza aquí por una matriz, pfOptions, por una LONG especificación de opción por archivo. Esto se debe a que el tipo de archivo puede variar de archivo a archivo.

Nota:

No es válido especificar las opciones SCC_FILETYPE_TEXT y SCC_FILETYPE_BINARY para el mismo archivo, pero no es válido especificar ninguno. La configuración no es la misma que la configuración SCC_FILETYPE_AUTO, en cuyo caso el complemento de control de código fuente detecta automáticamente el tipo de archivo.

A continuación se muestra la lista de marcas usadas en la pfOptions matriz:

Opción	Valor	Significado
SCC_FILETYPE_AUTO	0x00	El complemento de control de código fuente debe detectar el tipo de archivo.
SCC_FILETYPE_TEXT	0x01	Indica un archivo de texto ASCII.
SCC_FILETYPE_BINARY	0x02	Indica un tipo de archivo distinto del texto ASCII.
SCC_ADD_STORELATEST	0x04	Almacena solo la copia más reciente del archivo, sin diferencias.
SCC_FILETYPE_TEXT_ANSI	0x08	Trata el archivo como texto ANSI.
SCC_FILETYPE_UTF8	0x10	Trata el archivo como texto Unicode en formato UTF8.
SCC_FILETYPE_UTF16LE	0x20	Trata el archivo como texto Unicode en formato UTF16 Little Endian.
SCC_FILETYPE_UTF16BE	0x40	Trata el archivo como texto Unicode en formato UTF16 Big Endian.

Consulte también

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