SccDirDiff (fonction)SccDirDiff Function

Cette fonction affiche les différences entre le répertoire local actuel sur le disque du client et le projet correspondant sous contrôle de code source.This function displays the differences between the current local directory on the client disk and the corresponding project under source control.

SyntaxeSyntax

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

ParamètresParameters

pContextpContext
[in] La structure de contexte plug-in de contrôle de code source.[in] The source control plug-in context structure.

hWndhWnd
[in] Handle vers la fenêtre de l’IDE que le plug-in de contrôle de code source peut utiliser en tant que parent pour toutes les boîtes de dialogue qu’il fournit.[in] A handle to the IDE window that the source control plug-in can use as a parent for any dialog boxes that it provides.

lpDirNamelpDirName
[in] Chemin d’accès complet vers le répertoire local pour lesquels vous voulez afficher une différence visual.[in] Fully qualified path to the local directory for which to show a visual difference.

dwFlagsdwFlags
[in] Indicateurs de commandes (consultez la section Notes section).[in] Command flags (see Remarks section).

pvOptionspvOptions
[in] Options spécifiques au plug-in du contrôle source.[in] Source control plug-in-specific options.

Valeur de retourReturn Value

L’implémentation de plug-in de contrôle de source de cette fonction est censée retourner l’une des valeurs suivantes :The source control plug-in implementation of this function is expected to return one of the following values:

ValueValue DescriptionDescription
SCC_OKSCC_OK Le répertoire sur le disque est le même que le projet de contrôle de code source.The directory on disk is the same as the project in source code control.
SCC_I_FILESDIFFERSCC_I_FILESDIFFER Le répertoire sur le disque est différent du projet dans le contrôle de code source.The directory on disk is different from the project in source code control.
SCC_I_RELOADFILESCC_I_RELOADFILE Un fichier ou un projet doit être rechargé.A file or project needs to be reloaded.
SCC_E_FILENOTCONTROLLEDSCC_E_FILENOTCONTROLLED Le répertoire n’est pas sous contrôle de code source.The directory is not under source code control.
SCC_E_NOTAUTHORIZEDSCC_E_NOTAUTHORIZED L’utilisateur n’est pas autorisé à effectuer cette opération.The user is not allowed to perform this operation.
SCC_E_ACCESSFAILURESCC_E_ACCESSFAILURE Impossible d’accéder au système de contrôle source, probablement en raison de problèmes réseau ou de contention.There was a problem accessing the source control system, probably due to network or contention issues. Une nouvelle tentative est recommandée.A retry is recommended.
SCC_E_NONSPECIFICERRORSCC_E_NONSPECIFICERROR

SCC_E_UNKNOWNERRORSCC_E_UNKNOWNERROR
Erreur non spécifique.Nonspecific failure.
SCC_E_FILENOTEXISTSCC_E_FILENOTEXIST Répertoire local est introuvable.Local directory could not be found.

NotesRemarks

Cette fonction est utilisée pour demander le contrôle de source de plug-in pour afficher la liste des modifications apportées à un répertoire spécifié à l’utilisateur.This function is used to instruct the source control plug-in to display to the user a list of changes to a specified directory. Le plug-in s’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.The plug-in opens its own window, in a format of its choice, to display the differences between the user's directory on disk and the corresponding project under version control.

Si une comparaison prend en charge de plug-in de répertoires du tout, il doit prendre en charge la comparaison des répertoires selon le nom de fichier même si les options « rapide-diff » ne sont pas pris en charge.If a plug-in supports comparison of directories at all, it must support comparison of directories on a file-name basis even if the "quick-diff" options are not supported.

dwFlags InterprétationInterpretation
SCC_DIFF_IGNORECASESCC_DIFF_IGNORECASE Comparaison respectant la casse (peut être utilisé pour une comparaison rapide ou visuel).Case-insensitive comparison (may be used for either quick diff or visual).
SCC_DIFF_IGNORESPACESCC_DIFF_IGNORESPACE Ignore l’espace blanc (peut être utilisé pour rapide-diff ou visuel).Ignores white space (may be used for either quick-diff or visual).
SCC_DIFF_QD_CONTENTSSCC_DIFF_QD_CONTENTS Si la prise en charge par le plug-in de contrôle de code source, en mode silencieux compare le répertoire, octet par octet.If supported by the source control plug-in, silently compares the directory, byte by byte.
SCC_DIFF_QD_CHECKSUMSCC_DIFF_QD_CHECKSUM Si pris en charge par le plug-in, en mode silencieux compare l’annuaire via une somme de contrôle ou, si non pris en charge, revient à SCC_DIFF_QD_CONTENTS.If supported by plug-in, silently compares the directory via a checksum, or, if not supported, falls back to SCC_DIFF_QD_CONTENTS.
SCC_DIFF_QD_TIMESCC_DIFF_QD_TIME Si pris en charge par le plug-in, en mode silencieux compare l’annuaire via son horodatage ou, si non pris en charge, se replie sur SCC_DIFF_QD_CHECKSUM ou SCC_DIFF_QD_CONTENTS.If supported by plug-in, silently compares the directory via its timestamp, or, if not supported, falls back on SCC_DIFF_QD_CHECKSUM or SCC_DIFF_QD_CONTENTS.

Note

Cette fonction utilise les mêmes indicateurs de commande en tant que le SccDiff.This function uses the same command flags as the SccDiff. Toutefois, un plug-in de contrôle de code source peut choisir de ne prend ne pas en charge l’opération « rapide-diff » pour les répertoires.However, a source control plug-in may choose to not support the "quick-diff" operation for directories.

Voir aussiSee Also

Fonctions d’API du plug-in de contrôle de code sourceSource Control Plug-in API Functions