Partager via

Fonction SccHistory

  • Article

Cette fonction affiche l’historique des fichiers spécifiés.

Syntaxe

SCCRTN SccHistory(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LONG      fOptions,
   LPCMDOPTS pvOptions
);

Paramètres

pvContext

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

hWnd

[in] Handle vers la fenêtre IDE que le plug-in de contrôle de code source peut utiliser comme parent pour toutes les boîtes de dialogue qu’il fournit.

nFiles

[in] Nombre de fichiers spécifiés dans le lpFileName tableau.

lpFileName

[in] Tableau de noms complets de fichiers.

fOptions

[in] Indicateurs de commande (actuellement non utilisés).

pvOptions

[in] Options spécifiques au plug-in de contrôle de code source.

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 L’historique des versions a été obtenu avec succès.
SCC_I_RELOADFILE Le système de contrôle de code source a réellement modifié le fichier sur le disque lors de l’extraction de l’historique (par exemple, en obtenant une ancienne version de celui-ci), de sorte que l’IDE doit recharger ce fichier.
SCC_E_FILENOTCONTROLLED Le fichier n’est pas sous contrôle de code source.
SCC_E_OPNOTSUPPORTED Le système de contrôle de code source ne prend pas en charge cette opération.
SCC_E_NOTAUTHORIZED L’utilisateur n’est pas autorisé à effectuer 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_PROJNOTOPEN Le projet n’a pas été ouvert.
SCC_E_NONSPECIFICERROR Échec non spécifique. Impossible d’obtenir l’historique des fichiers.

Notes

Le plug-in de contrôle de code source peut afficher sa propre boîte de dialogue pour afficher l’historique de chaque fichier, à l’aide hWnd de la fenêtre parente. Vous pouvez également utiliser la fonction de rappel de sortie de texte facultative fournie au SccOpenProject , si elle est prise en charge.

Notez que, dans certaines circonstances, le fichier examiné peut changer pendant l’exécution de cet appel. Par exemple, la commande d’historique visual source Coffre permet à l’utilisateur d’obtenir une ancienne version du fichier. Dans ce cas, le plug-in de contrôle de code source retourne SCC_I_RELOAD pour avertir l’IDE qu’il doit recharger le fichier.

Remarque

Si le plug-in de contrôle de code source ne prend pas en charge cette fonction pour un tableau de fichiers, seul l’historique des fichiers du premier fichier peut être affiché.

Voir aussi