SccCheckin (fonction)SccCheckin Function

Cette fonction vérifie dans les fichiers extraits précédemment pour le système de contrôle de code source, stocke les modifications et la création d’une nouvelle version.This function checks in previously checked-out files to the source control system, storing the changes and creating a new version. Cette fonction est appelée avec un nombre et un tableau de noms de fichiers à archiver.This function is called with a count and an array of names of the files to be checked in.

SyntaxeSyntax

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

ParamètresParameters

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

hWndhWnd
[in] Un handle de fenêtre IDE qui permet l’analyse de plug-in en tant que parent pour toutes les boîtes de dialogue qu’il fournit.[in] A handle to the IDE window that the SCC plug-in can use as a parent for any dialog boxes that it provides.

nFilesnFiles
[in] Nombre de fichiers sélectionnés à être archivé.[in] Number of files selected to be checked in.

lpFileNameslpFileNames
[in] Tableau des noms de chemin qualifié complet des fichiers à archiver.[in] Array of fully qualified local path names of files to be checked in.

lpCommentlpComment
[in] Commentaire à appliquer à chaque fichier sélectionné en cours d’archivage.[in] Comment to be applied to each of the selected files being checked in. Il s’agit de NULL si le plug-in de contrôle de code source doit inviter à entrer un commentaire.This is NULL if the source control plug-in should prompt for a comment.

fOptionsfOptions
[in] Indicateurs de commande, soit 0 ou SCC_KEEP_CHECKEDOUT.[in] Command flags, either 0 or SCC_KEEP_CHECKEDOUT.

pvOptionspvOptions
[in] Options spécifiques au plug-in de contrôle de code source.[in] SCC 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 Fichiers a réussi.Files was successfully checked in.
SCC_E_FILENOTCONTROLLEDSCC_E_FILENOTCONTROLLED Le fichier sélectionné n’est pas sous contrôle de code source.The selected file is not under source code control.
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 Erreur non spécifique.Nonspecific failure. Fichier n’a pas été activé.File was not checked in.
SCC_E_NOTCHECKEDOUTSCC_E_NOTCHECKEDOUT L’utilisateur n’a pas extrait le fichier ne peut pas archiver.The user has not checked out the file, so cannot check it in.
SCC_E_CHECKINCONFLICTSCC_E_CHECKINCONFLICT Archivage n’a pas pu être effectuée car :Checkin could not be performed because:

-Un autre utilisateur a archivé avance et bAutoReconcile a la valeur false.- Another user has checked in ahead and bAutoReconcile was false.

- ou --or-

-La fusion automatique ne peut pas être effectuée (par exemple, lorsque les fichiers sont binaires).- The auto-merge cannot be done (for example, when files are binary).
SCC_E_VERIFYMERGESCC_E_VERIFYMERGE Fichier a été fusionnée automatiquement, mais n’a pas été vérifiée en attente de vérification de l’utilisateur.File has been auto-merged but has not been checked in pending user verification.
SCC_E_FIXMERGESCC_E_FIXMERGE Fichier a été fusionnée automatiquement, mais n’a pas été archivé en raison d’un conflit de fusion qui doit être résolu manuellement.File has been auto-merged but has not been checked in due to a merge conflict that must be manually resolved.
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_I_OPERATIONCANCELEDSCC_I_OPERATIONCANCELED Opération a été annulée avant la fin.Operation was cancelled before completion.
SCC_I_RELOADFILESCC_I_RELOADFILE Un fichier ou un projet doit être rechargé.A file or project needs to be reloaded.
SCC_E_FILENOTEXISTSCC_E_FILENOTEXIST Impossible de trouver le fichier local.Local file was not found.

NotesRemarks

Le commentaire s’applique à tous les fichiers en cours d’archivage.The comment applies to all files being checked in. L’argument de commentaire peut être un null de chaîne, auquel cas le plug-in de contrôle de code source peut demander à l’utilisateur pour une chaîne de commentaire pour chaque fichier.The comment argument can be a null string, in which case the source control plug-in can prompt the user for a comment string for each file.

Le fOptions argument peut être donné à une valeur de la SCC_KEEP_CHECKEDOUT indicateur pour indiquer l’intention de l’utilisateur à archiver le fichier et l’extraire à nouveau.The fOptions argument can be given a value of the SCC_KEEP_CHECKEDOUT flag to indicate the user's intent to check the file in and check it out again.

Voir aussiSee Also

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