SccQueryInfo, fonction
Cette fonction obtient les informations d'état d'un ensemble de fichiers sélectionnés sous contrôle de code source.
SCCRTN SccQueryInfo(
LPVOID pvContext,
LONG nFiles,
LPCSTR* lpFileNames,
LPLONG lpStatus
);
Paramètres
pvContext
[in] La structure du plug-in du contexte de contrôle de code source.nFiles
[in] Nombre de fichiers spécifiés dans le tableau d' lpFileNames et la longueur du tableau d' lpStatus .lpFileNames
[in] Un tableau de noms des fichiers à interroger.lpStatus
[in, out] Un tableau dans lequel le plug-in contrôle de code source retourne l'état diminue pour chaque fichier. Pour plus d'informations, consultez Énumérateur de code de statut de fichier.
Valeur de retour
Il est recommandé que l'implémentation du plug-in du contrôle de code source de cette fonction retourne une des valeurs suivantes :
Valeur |
Description |
|---|---|
SCC_OK |
La requête a abouti. |
SCC_E_ACCESSFAILURE |
Un problème est survenu avec accéder au système de contrôle de code source, provoqué éventuellement des problèmes de réseau ou de conflit. Une démarrage est recommandée. |
SCC_E_PROJNOTOPEN |
Le projet n'est pas contrôle de code source de sous ouvert. |
SCC_E_NONSPECIFICERROR |
échec non spécifique. |
Notes
Si lpFileName est une chaîne vide, il n'existe actuellement aucune information d'état à mettre à jour. Sinon, il s'agit du chemin d'accès complet du fichier pour lequel les informations d'état ont été modifiés.
Tableau de retour peut être un masque de bits des bits d' SCC_STATUS_xxxx . Pour plus d'informations, consultez Énumérateur de code de statut de fichier. Un système de contrôle de code source ne prend pas en charge tous les types de bits. Par exemple, si SCC_STATUS_OUTOFDATE n'est pas envoyé, le bit n'est pas immédiatement défini.
Lors de l'utilisation de cette fonction les fichiers, notez les spécifications suivantes d'état d' MSSCCI :
SCC_STATUS_OUTBYUSER est défini lorsque l'utilisateur a extrait le fichier.
SCC_STATUS_CHECKEDOUT ne peut pas être défini à moins qu' SCC_STATUS_OUTBYUSER soit défini.
SCC_STATUS_CHECKEDOUT est défini uniquement lorsque le fichier est activé- dans le répertoire de travail indiqué.
Si le fichier est activé- par l'utilisateur actuel dans un répertoire différent du répertoire de travail, SCC_STATUS_OUTBYUSER est défini mais SCC_STATUS_CHECKEDOUT n'est pas.
Voir aussi
Référence
Énumérateur de code de statut de fichier