Funzione SccCheckin

Articolo
01/13/2024

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.

Vedi anche

Funzioni API del plug-in del controllo del codice sorgente

Condividi tramite