Fonction SccQueryInfo

  • Article

Cette fonction obtient des informations d’état pour un ensemble de fichiers sélectionnés sous contrôle de code source.

Syntaxe

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

Paramètres

pvContext

[in] Structure de contexte du plug-in de contrôle de code source.

nFiles

[in] Nombre de fichiers spécifiés dans le lpFileNames tableau et la longueur du lpStatus tableau.

lpFileNames

[in] Tableau de noms de fichiers à interroger.

lpStatus

[in, out] Tableau dans lequel le plug-in de contrôle de code source retourne les indicateurs d’état pour chaque fichier. Pour plus d’informations, consultez Code d’état du fichier.

Valeur de retour

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_ACCESSFAILURE Il y a eu un problème d’accès au système de contrôle de code source, probablement dû à des problèmes de réseau ou de contention. Une nouvelle tentative est recommandée.
SCC_E_PROJNOTOPEN Le projet n’est pas ouvert sous contrôle de code source.
SCC_E_NONSPECIFICERROR Échec non spécifique.

Notes

S’il lpFileName s’agit d’une chaîne vide, il n’existe actuellement aucune information d’état à mettre à jour. Sinon, il s’agit du nom complet du chemin d’accès du fichier pour lequel les informations d’état peuvent avoir changé.

Le tableau de retour peut être un masque de SCC_STATUS_xxxx bits. Pour plus d’informations, consultez Code d’état du fichier. Un système de contrôle de code source peut ne pas prendre en charge tous les types de bits. Par exemple, si SCC_STATUS_OUTOFDATE ce n’est pas le cas, le bit n’est pas défini.

Lorsque vous utilisez cette fonction pour case activée fichiers sortants, notez les exigences d’état suivantes MSSCCI :

  • SCC_STATUS_OUTBYUSERest défini lorsque l’utilisateur actuel a case activée sorti le fichier.

  • SCC_STATUS_CHECKEDOUT ne peut pas être défini, sauf si SCC_STATUS_OUTBYUSER elle est définie.

  • SCC_STATUS_CHECKEDOUTest défini uniquement lorsque le fichier est case activée ed-out dans le répertoire de travail désigné.

  • Si le fichier est case activée ed-out par l’utilisateur actuel dans un répertoire autre que le répertoire de travail, SCC_STATUS_OUTBYUSER il est défini, mais SCC_STATUS_CHECKEDOUT pas.

Voir aussi