Funzione SccAdd

Articolo
01/13/2024

Questa funzione aggiunge nuovi file al sistema di controllo del codice sorgente.

Sintassi

SCCRTN SccAdd(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LPCSTR    lpComment,
   LONG*     pfOptions,
   LPCMDOPTS pvOptions
);

Parametri

pvContext

[in] Struttura del contesto del plug-in del controllo del codice sorgente.

hWnd

[in] Handle per la finestra dell'IDE che il plug-in del controllo del codice sorgente può usare come elemento padre per qualsiasi finestra di dialogo fornita.

nFiles

[in] Numero di file selezionati da aggiungere al progetto corrente, come indicato nella lpFileNames matrice.

lpFileNames

[in] Matrice di nomi locali completi dei file da aggiungere.

lpComment

[in] Commento da applicare a tutti i file da aggiungere.

pfOptions

[in] Matrice di flag di comando, forniti per ogni file.

pvOptions

[in] Opzioni specifiche del plug-in del controllo del codice sorgente.

Valore restituito

L'implementazione del plug-in del controllo del codice sorgente di questa funzione dovrebbe restituire uno dei valori seguenti:

Valore	Descrizione
SCC_OK	Operazione di aggiunta completata.
SCC_E_FILEALREADYEXISTS	Il file selezionato è già sotto il controllo del codice sorgente.
SCC_E_TYPENOTSUPPORTED	Il tipo del file (ad esempio binario) non è supportato dal sistema di controllo del codice sorgente.
SCC_E_OPNOTSUPPORTED	Il sistema di controllo del codice sorgente non supporta questa operazione.
SCC_E_ACCESSFAILURE	Si è verificato un problema durante l'accesso al sistema di controllo del codice sorgente, probabilmente a causa di problemi di rete o contesa. È consigliabile riprovare.
SCC_E_NOTAUTHORIZED	L'utente non è autorizzato a eseguire questa operazione.
SCC_E_NONSPECIFICERROR	Errore non specifico; aggiunta non eseguita.
SCC_I_OPERATIONCANCELED	L'operazione è stata annullata prima del completamento.
SCC_I_RELOADFILE	È necessario ricaricare un file o un progetto.
SCC_E_FILENOTEXIST	Impossibile trovare il file locale.

Osservazioni:

Il solito fOptions vengono sostituiti da una matrice, pfOptions, con una LONG specifica di opzione per ogni file. Questo perché il tipo di file può variare da file a file.

Nota

Non è valido specificare entrambe le SCC_FILETYPE_TEXT opzioni e SCC_FILETYPE_BINARY per lo stesso file, ma è valido per specificare nessuno dei due file. L'impostazione SCC_FILETYPE_AUTOdi nessuno dei due è uguale a , nel qual caso il plug-in del controllo del codice sorgente rileva automaticamente il tipo di file.

Di seguito è riportato l'elenco dei flag usati nella pfOptions matrice:

Opzione	Valore	Significato
SCC_FILETYPE_AUTO	0x00	Il plug-in del controllo del codice sorgente deve rilevare il tipo di file.
SCC_FILETYPE_TEXT	0x01	Indica un file di testo ASCII.
SCC_FILETYPE_BINARY	0x02	Indica un tipo di file diverso dal testo ASCII.
SCC_ADD_STORELATEST	0x04	Archivia solo la copia più recente del file, senza delta.
SCC_FILETYPE_TEXT_ANSI	0x08	Considera il file come testo ANSI.
SCC_FILETYPE_UTF8	0x10	Considera il file come testo Unicode in formato UTF8.
SCC_FILETYPE_UTF16LE	0x20	Considera il file come testo Unicode in formato UTF16 Little Endian.
SCC_FILETYPE_UTF16BE	0x40	Considera il file come testo Unicode in formato Big Endian UTF16.

Vedi anche

Funzioni API del plug-in del controllo del codice sorgente

Condividi tramite