Función SccDirQueryInfo
Esta función examina una lista de directorios completos para su estado actual.
Sintaxis
SCCRTN SccDirQueryInfo(
LPVOID pContext,
LONG nDirs,
LPCSTR* lpDirNames,
LPLONG lpStatus
);
Parámetros
pContext
[in] Estructura del contexto del complemento de control de código fuente.
nDirs
[in] Número de directorios seleccionados que se van a consultar.
lpDirNames
[in] Matriz de rutas de acceso completas de los directorios que se van a consultar.
lpStatus
[dentro, fuera] Estructura de matriz del complemento de control de código fuente para devolver las marcas de estado (consulte Código de estado del directorio para obtener más información).
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_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_NONSPECIFICERROR SCC_E_UNKNOWNERROR |
Error no específico. |
Comentarios
La función rellena la matriz de retorno con una máscara de bits de bits de la SCC_DIRSTATUS familia (vea Código de estado de directorio), una entrada para cada directorio especificado. El autor de la llamada asigna la matriz de estado.
El IDE usa esta función antes de cambiar el nombre de un directorio para comprobar si el directorio está bajo control de código fuente consultando si tiene un proyecto correspondiente. Si el directorio no está bajo control de código fuente, el IDE puede proporcionar la advertencia adecuada al usuario.
Nota:
Si un complemento de control de código fuente decide no implementar uno o varios de los valores de estado, los bits no implementados deben establecerse en cero.