Funzione SccCheckin
Questa funzione archivia i file estratto in precedenza nel sistema di controllo del codice sorgente, archiviando le modifiche e creando una nuova versione. Questa funzione viene chiamata con un conteggio e una matrice di nomi dei file da archiviare.
Sintassi
SCCRTN SccCheckin (
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPSTR* lpFileNames,
LPCSTR lpComment,
LONG fOptions,
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 SCC può usare come elemento padre per qualsiasi finestra di dialogo fornita.
nFiles
[in] Numero di file selezionati per l'archiviazione.
lpFileNames
[in] Matrice di nomi di percorso locali completi dei file da archiviare.
lpComment
[in] Commento da applicare a ogni file selezionato archiviato. Questo parametro è NULL se il plug-in del controllo del codice sorgente deve richiedere un commento.
fOptions
[in] Flag di comando, 0 o SCC_KEEP_CHECKEDOUT.
pvOptions
[in] Opzioni specifiche del plug-in SCC.
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 | Il file è stato archiviato correttamente. |
| SCC_E_FILENOTCONTROLLED | Il file selezionato non è incluso nel controllo del codice sorgente. |
| 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_NONSPECIFICERROR | Errore non specifico. Il file non è stato archiviato. |
| SCC_E_NOTCHECKEDOUT | L'utente non ha estratto il file, quindi non può archiviarlo. |
| SCC_E_CHECKINCONFLICT | Impossibile eseguire l'archiviazione perché: - Un altro utente ha eseguito l'archiviazione in anticipo ed bAutoReconcile è false.-o- - Impossibile eseguire l'unione automatica , ad esempio quando i file sono binari. |
| SCC_E_VERIFYMERGE | Il file è stato unito automaticamente ma non è stato archiviato in attesa di verifica utente. |
| SCC_E_FIXMERGE | Il file è stato unito automaticamente ma non è stato archiviato a causa di un conflitto di merge che deve essere risolto manualmente. |
| SCC_E_NOTAUTHORIZED | L'utente non è autorizzato a eseguire questa operazione. |
| SCC_I_OPERATIONCANCELED | Operazione annullata prima del completamento. |
| SCC_I_RELOADFILE | È necessario ricaricare un file o un progetto. |
| SCC_E_FILENOTEXIST | Impossibile trovare il file locale. |
Osservazioni:
Il commento si applica a tutti i file da archiviare. L'argomento commento può essere una null stringa, nel qual caso il plug-in del controllo del codice sorgente può richiedere all'utente una stringa di commento per ogni file.
All'argomento fOptions può essere assegnato un valore del SCC_KEEP_CHECKEDOUT flag per indicare la finalità dell'utente di archiviare il file ed estrarlo di nuovo.