Fonction SccDirQueryInfo
Cette fonction examine la liste des répertoires qualifiés complets pour leur état actuel.
Syntaxe
SCCRTN SccDirQueryInfo(
LPVOID pContext,
LONG nDirs,
LPCSTR* lpDirNames,
LPLONG lpStatus
);
Paramètres
pContext
[in] Structure de contexte du plug-in de contrôle de code source.
nDirs
[in] Nombre de répertoires sélectionnés pour être interrogés.
lpDirNames
[in] Tableau de chemins complets des répertoires à interroger.
lpStatus
[in, out] Structure de tableau pour le plug-in de contrôle de code source pour retourner les indicateurs d’état (consultez le code d’état du répertoire pour plus d’informations).
Valeur retournée
L’implémentation du plug-in de contrôle de code source de cette fonction est censée retourner l’une des valeurs suivantes :
| Valeur | Description |
|---|---|
| SCC_OK | La requête a réussi. |
| SCC_E_OPNOTSUPPORTED | Le système de contrôle de code source ne prend pas en charge cette opération. |
| SCC_E_ACCESSFAILURE | Il y a eu un problème d’accès au système de contrôle de code source, probablement en raison de problèmes de réseau ou de contention. Une nouvelle tentative est recommandée. |
| SCC_E_NONSPECIFICERROR SCC_E_UNKNOWNERROR |
Échec non spécifique. |
Notes
La fonction remplit le tableau de retour avec un masque de bits de la SCC_DIRSTATUS famille (voir le code d’état du répertoire), une entrée pour chaque répertoire donné. Le tableau d’état est alloué par l’appelant.
L’IDE utilise cette fonction avant qu’un répertoire soit renommé en case activée si le répertoire est sous contrôle de code source en interrogeant s’il a un projet correspondant. Si le répertoire n’est pas sous contrôle de code source, l’IDE peut fournir l’avertissement approprié à l’utilisateur.
Remarque
Si un plug-in de contrôle de code source choisit de ne pas implémenter une ou plusieurs valeurs d’état, les bits non implémentés doivent être définis sur zéro.