Fonction SccCheckin
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.