SccAdd, fonction
Cette fonction ajoute de nouveaux fichiers dans le système de contrôle de code source.
SCCRTN SccAdd(
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* lpFileNames,
LPCSTR lpComment,
LONG* pfOptions,
LPCMDOPTS pvOptions
);
Paramètres
pvContext
[in] La structure du plug-in du contexte de contrôle de code source.hWnd
[in] Un handle de la fenêtre IDE que le plug-in contrôle de code source peut utiliser en tant que parent pour toutes les boîtes de dialogue qu'elle fournit.nFiles
[in] Nombre de fichiers sélectionnés pour être ajouté au projet actuel comme indiqué dans le tableau d' lpFileNames .lpFileNames
[in] Tableau de noms régionaux qualifiés complets des fichiers à ajouter.lpComment
[in] Le commentaire à appliquer à tous les fichiers qui sont ajoutés.pfOptions
[in] Tableau d'indicateurs de commande, si sur la base de fichiers.pvOptions
[in] options de prise-dans-détail de contrôle de code source.
Valeur de retour
Il est recommandé que l'implémentation du plug-in du contrôle de code source de cette fonction retourne une des valeurs suivantes :
Valeur |
Description |
|---|---|
SCC_OK |
L'addition a abouti. |
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 |
Un problème est survenu lors de l'accès au système de contrôle de code source, probablement en raison de problèmes de réseau ou de conflit. Une démarrage est recommandée. |
SCC_E_NOTAUTHORIZED |
N'est pas autorisé à effectuer cette opération. |
SCC_E_NONSPECIFICERROR |
échec non spécifique ; ajoutez pas exécuté. |
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
fOptions habituel sont remplacés ici par une matrice, pfOptions, avec la spécification d'une option d' LONG par fichier. Cela est dû au fait que le type de fichier peut varier du fichier au fichier.
Notes
Il est possible de spécifier SCC_FILETYPE_TEXT les options et pour SCC_FILETYPE_BINARY pour le même fichier, mais est valide pour ne spécifiez aucun.Ne définir aucune revient à définir SCC_FILETYPE_AUTO, auquel cas le plug-in contrôle de code source détecte automatiquement le type de fichier.
Vous trouverez ci-dessous la liste des balises utilisées dans le tableau d' pfOptions :
Option |
Valeur |
Signification |
|---|---|---|
SCC_FILETYPE_AUTO |
0x00 |
Le plug-in contrôle de code source doit détecter le type de fichier. |
SCC_FILETYPE_TEXT |
0x01 |
indique 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, aucun deltas. |
SCC_FILETYPE_TEXT_ANSI |
0x08 |
Traite le fichier en tant que texte ANSI. |
SCC_FILETYPE_UTF8 |
0x10 |
Traite le fichier comme texte Unicode dans le format UTF8. |
SCC_FILETYPE_UTF16LE |
0x20 |
Traite le fichier comme texte Unicode dans le petit Endian format d'UTF16. |
SCC_FILETYPE_UTF16BE |
0x40 |
Traite le fichier en tant que texte Unicode dans le format UTF16 avec primauté des octets de poids fort. |