Fonction SccCheckinSccCheckin function

Cette fonction vérifie dans les fichiers précédemment extraits vers le système de contrôle source, enregistrer 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 des 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 de plug-in de contrôle de source.[in] The source control plug-in context structure.

hWndhWnd
[in] Handle vers la fenêtre de l’IDE que le plug-in de SCC peut utiliser en tant que parent pour 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 pour être archivé.[in] Number of files selected to be checked in.

lpFileNameslpFileNames
[in] Tableau des noms de chemin d’accès local complet des fichiers à archiver.[in] Array of fully qualified local path names of files to be checked in.

lpCommentlpComment
[in] Commentaire à appliquer à chacun des fichiers sélectionnés en cours d’archivage.[in] Comment to be applied to each of the selected files being checked in. Ce paramètre est NULL si le plug-in de contrôle de code source doit demander un commentaire.This parameter is NULL if the source control plug-in should prompt for a comment.

OptionsfOptions
[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 Fichier a été extrait.File 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, donc 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é à l’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 automatique mais n’a pas été archivé 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 automatique 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 canceled 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 Fichier local est introuvable.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 string, auquel cas le plug-in de contrôle de code source peut inviter 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 recevoir 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 source contrôle plug-inSource control plug-in API functions