Fonction SccDirDiff

Article
01/13/2024

Cette fonction affiche les différences entre le répertoire local actuel sur le disque client et le projet correspondant sous contrôle de code source.

Syntaxe

SCCRTN SccDirDiff(
   LPVOID    pContext,
   HWND      hWnd,
   LPCSTR    lpDirName,
   LONG      dwFlags,
   LPCMDOPTS pvOptions
);

Paramètres

pContext

[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.

lpDirName

[in] Chemin d’accès complet au répertoire local pour lequel afficher une différence visuelle.

dwFlags

[in] Indicateurs de commande (voir la section Remarques).

pvOptions

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

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	Le répertoire sur disque est identique au projet dans le contrôle de code source.
SCC_I_FILESDIFFER	Le répertoire sur disque est différent du projet dans le contrôle de code source.
SCC_I_RELOADFILE	Un fichier ou un projet doit être rechargé.
SCC_E_FILENOTCONTROLLED	Le répertoire n’est pas sous contrôle de code source.
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_NONSPECIFICERROR SCC_E_UNKNOWNERROR	Échec non spécifique.
SCC_E_FILENOTEXIST	Le répertoire local est introuvable.

Notes

Cette fonction est utilisée pour indiquer au plug-in de contrôle de code source d’afficher à l’utilisateur une liste de modifications apportées à un répertoire spécifié. Le plug-in ouvre sa propre fenêtre, dans un format de son choix, pour afficher les différences entre le répertoire de l’utilisateur sur le disque et le projet correspondant sous contrôle de version.

Si un plug-in prend en charge la comparaison des répertoires du tout, il doit prendre en charge la comparaison des répertoires sur une base de nom de fichier même si les options « quick-diff » ne sont pas prises en charge.

`dwFlags`	Interprétation
SCC_DIFF_IGNORECASE	Comparaison non sensible à la casse (peut être utilisée pour les différences rapides ou visuelles).
SCC_DIFF_IGNORESPACE	Ignore l’espace blanc (peut être utilisé pour les différences rapides ou visuelles).
SCC_DIFF_QD_CONTENTS	Si le plug-in de contrôle de code source est pris en charge, compare silencieusement le répertoire, octet par octet.
SCC_DIFF_QD_CHECKSUM	Si le plug-in est pris en charge, compare silencieusement le répertoire via un case activée sum ou, s’il n’est pas pris en charge, revient à SCC_DIFF_QD_CONTENTS.
SCC_DIFF_QD_TIME	Si le plug-in est pris en charge, compare silencieusement le répertoire via son horodatage, ou, s’il n’est pas pris en charge, revient sur SCC_DIFF_QD_CHECKSUM ou SCC_DIFF_QD_CONTENTS.

Remarque

Cette fonction utilise les mêmes indicateurs de commande que sccDiff. Toutefois, un plug-in de contrôle de code source peut choisir de ne pas prendre en charge l’opération « quick-diff » pour les répertoires.

Voir aussi

Fonctions d’API de plug-in de contrôle de code source

Partager via