Partager via


Fonction SccAdd

Cette fonction ajoute de nouveaux fichiers au système de contrôle de code source.

Syntaxe

SCCRTN SccAdd(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LPCSTR    lpComment,
   LONG*     pfOptions,
   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 de contrôle de code source peut utiliser comme parent pour toutes les boîtes de dialogue qu’il fournit.

nFiles

[in] Nombre de fichiers sélectionnés à ajouter au projet actuel comme indiqué dans le lpFileNames tableau.

lpFileNames

[in] Tableau de noms locaux complets de fichiers à ajouter.

lpComment

[in] Commentaire à appliquer à tous les fichiers ajoutés.

pfOptions

[in] Tableau d’indicateurs de commande, fourni par fichier.

pvOptions

[in] Options spécifiques au plug-in de contrôle de code source.

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 L’opération d’ajout a réussi.
SCC_E_FILEALREADYEXISTS Le fichier sélectionné est déjà sous contrôle de code source.
SCC_E_TYPENOTSUPPORTED Le type du fichier (par exemple, binaire) n’est pas pris en charge par le système de contrôle de code source.
SCC_E_OPNOTSUPPORTED Le système de contrôle de code source ne prend pas en charge cette opération.
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_NOTAUTHORIZED L’utilisateur n’est pas autorisé à effectuer cette opération.
SCC_E_NONSPECIFICERROR Échec non spécifique ; ajouter non effectué.
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

Les habitudes fOptions sont remplacées ici par un tableau, pfOptionsavec une spécification d’option LONG par fichier. Cela est dû au fait que le type de fichier peut varier d’un fichier à l’autre.

Remarque

Il n’est pas valide de spécifier les deux SCC_FILETYPE_TEXT et SCC_FILETYPE_BINARY les options du même fichier, mais il est valide pour spécifier ni l’un ni l’autre. Le paramètre n’est pas le même que le paramètre SCC_FILETYPE_AUTO, auquel cas le plug-in de contrôle de code source détecte automatiquement le type de fichier.

Voici la liste des indicateurs utilisés dans le pfOptions tableau :

Option Valeur Signification
SCC_FILETYPE_AUTO 0x00 Le plug-in de contrôle de code source doit détecter le type de fichier.
SCC_FILETYPE_TEXT 0x01 Indique qu’il s’agit d’un fichier texte ASCII.
SCC_FILETYPE_BINARY 0x02 Indique un type de fichier autre que le texte ASCII.
SCC_ADD_STORELATEST 0x04 Stocke uniquement la dernière copie du fichier, pas de deltas.
SCC_FILETYPE_TEXT_ANSI 0x08 Traite le fichier en tant que texte ANSI.
SCC_FILETYPE_UTF8 0x10 Traite le fichier en tant que texte Unicode au format UTF8.
SCC_FILETYPE_UTF16LE 0x20 Traite le fichier en tant que texte Unicode au format UTF16 Little Endian.
SCC_FILETYPE_UTF16BE 0x40 Traite le fichier en tant que texte Unicode au format UTF16 Big Endian.

Voir aussi