Fonction SccAdd

Article
01/13/2024

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

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