SccUncheckout (fonction)SccUncheckout Function

Cette fonction annule une opération d’extraction précédente, restaurant ainsi le contenu de l’ou les fichiers sélectionnés à l’état précédant l’extraction.This function undoes a previous checkout operation, thereby restoring the contents of the selected file or files to the state prior to the checkout. Toutes les modifications apportées au fichier depuis l’extraction sont perdues.All changes made to the file since the checkout are lost.

SyntaxeSyntax

SCCRTN SccUncheckout (  
   LPVOID    pvContext,  
   HWND      hWnd,  
   LONG      nFiles,  
   LPCSTR*   lpFileNames,  
   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] 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.

nFilesnFiles
[in] Nombre de fichiers spécifiés dans le lpFileNames tableau.[in] Number of files specified in the lpFileNames array.

lpFileNameslpFileNames
[in] Tableau des noms de chemin qualifié complet de fichiers pour lequel annuler une extraction.[in] Array of fully qualified local path names of files for which to undo a checkout.

fOptionsfOptions
[in] Indicateurs de commande (non utilisés).[in] Command flags (not used).

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 Annuler l’extraction a réussi.Undo checkout was successful.
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. Annuler l’extraction n’a pas réussi.Undo checkout did not succeed.
SCC_E_NOTCHECKEDOUTSCC_E_NOTCHECKEDOUT L’utilisateur n’a pas extrait le fichier.The user does not have the file checked out.
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_PROJNOTOPENSCC_E_PROJNOTOPEN Le projet n’a pas été ouvert à partir du contrôle de code source.The project has not been opened from source control.
SCC_I_OPERATIONCANCELEDSCC_I_OPERATIONCANCELED L’opération a été annulée avant la fin.The operation was cancelled before completion.

NotesRemarks

Après cette opération, le SCC_STATUS_CHECKEDOUT et SCC_STATUS_MODIFIED indicateurs seront désactivées pour les fichiers sur lequel l’extraction a été effectuée.After this operation, the SCC_STATUS_CHECKEDOUT and SCC_STATUS_MODIFIED flags will both be cleared for the files on which the undo checkout was performed.

Voir aussiSee Also

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