Fonction SccCheckin

Article
01/13/2024

Cette fonction case activée dans les fichiers précédemment case activée ed-out dans le système de contrôle de code source, en stockant les modifications et en créant une nouvelle version. Cette fonction est appelée avec un nombre et un tableau de noms des fichiers à case activée.

Syntaxe

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

Paramètres

pvContext

[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 SCC peut utiliser comme parent pour toutes les boîtes de dialogue qu’il fournit.

nFiles

[in] Nombre de fichiers sélectionnés pour être case activée dans.

lpFileNames

[in] Tableau de noms de chemins locaux complets de fichiers à case activée.

lpComment

[in] Commentaire à appliquer à chacun des fichiers sélectionnés en cours de case activée. Ce paramètre est NULL si le plug-in de contrôle de code source doit demander un commentaire.

fOptions

[in] Indicateurs de commande, soit 0, soit SCC_KEEP_CHECKEDOUT.

pvOptions

[in] Options spécifiques au plug-in SCC.

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 fichier a été correctement case activée inséré.
SCC_E_FILENOTCONTROLLED	Le fichier sélectionné n’est pas sous contrôle de code source.
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	Échec non spécifique. Le fichier n’a pas été case activée.
SCC_E_NOTCHECKEDOUT	L’utilisateur n’a pas case activée sorti le fichier. Par conséquent, il ne peut pas case activée-le.
SCC_E_CHECKINCONFLICT	La vérification n’a pas pu être effectuée, car : - Un autre utilisateur a case activée en avance et `bAutoReconcile` a été faux. -ou- - La fusion automatique ne peut pas être effectuée (par exemple, lorsque les fichiers sont binaires).
SCC_E_VERIFYMERGE	Le fichier a été fusionné automatiquement, mais n’a pas été case activée en attente de vérification de l’utilisateur.
SCC_E_FIXMERGE	Le fichier a été fusionné automatiquement, mais n’a pas été case activée en raison d’un conflit de fusion qui doit être résolu manuellement.
SCC_E_NOTAUTHORIZED	L’utilisateur n’est pas autorisé à effectuer cette opération.
SCC_I_OPERATIONCANCELED	L’opération a été annulée avant l’achèvement.
SCC_I_RELOADFILE	Un fichier ou un projet doit être rechargé.
SCC_E_FILENOTEXIST	Le fichier local est introuvable.

Notes

Le commentaire s’applique à tous les fichiers en cours d’case activée. L’argument de commentaire peut être une null chaîne, auquel cas le plug-in de contrôle de code source peut inviter l’utilisateur à entrer une chaîne de commentaire pour chaque fichier.

L’argument fOptions peut être donné une valeur de l’indicateur SCC_KEEP_CHECKEDOUT pour indiquer l’intention de l’utilisateur d’case activée le fichier dans et de l’case activée à nouveau.

Voir aussi

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

Partager via