SccQueryInfo (Función)

  • Artículo

Esta función obtiene información de estado de un conjunto de archivos seleccionados bajo el control de código fuente.

Sintaxis

SCCRTN SccQueryInfo(
   LPVOID  pvContext,
   LONG    nFiles,
   LPCSTR* lpFileNames,
   LPLONG  lpStatus
);

Parámetros

pvContext

[in] Estructura del contexto del complemento de control de código fuente.

nFiles

[in] Número de archivos especificados en la lpFileNames matriz y la longitud de la lpStatus matriz.

lpFileNames

[in] Matriz de nombres de archivos que se van a consultar.

lpStatus

[dentro, fuera] Matriz en la que el complemento de control de código fuente devuelve las marcas de estado de cada archivo. Para obtener más información, vea Código de estado de archivo.

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 consulta se realizó correctamente.
SCC_E_ACCESSFAILURE Hubo un problema con el acceso al sistema de control de código fuente, probablemente causado por problemas de red o contención. Se recomienda un reintento.
SCC_E_PROJNOTOPEN El proyecto no está abierto bajo el control de código fuente.
SCC_E_NONSPECIFICERROR Error no específico.

Comentarios

Si lpFileName es una cadena vacía, actualmente no hay información de estado que actualizar. De lo contrario, es el nombre de ruta de acceso completo del archivo para el que puede haber cambiado la información de estado.

La matriz de retorno puede ser una máscara de bits de SCC_STATUS_xxxx bits. Para obtener más información, vea Código de estado de archivo. Es posible que un sistema de control de código fuente no admita todos los tipos de bits. Por ejemplo, si SCC_STATUS_OUTOFDATE no se ofrece, el bit no se establece.

Al usar esta función para desactive los archivos, tenga en cuenta los siguientes MSSCCI requisitos de estado:

  • SCC_STATUS_OUTBYUSER se establece cuando el usuario actual ha desprotegido el archivo.

  • SCC_STATUS_CHECKEDOUT no se puede establecer a menos que SCC_STATUS_OUTBYUSER se establezca.

  • SCC_STATUS_CHECKEDOUT solo se establece cuando el archivo está desprotegido en el directorio de trabajo designado.

  • Si el usuario actual desprotegió el archivo en un directorio distinto del directorio de trabajo, se establece pero SCC_STATUS_OUTBYUSERSCC_STATUS_CHECKEDOUT no lo está.

Consulte también