Funzione SccCheckout
Dato un elenco di nomi di file completi, questa funzione li archivia nell'unità locale. Il commento si applica a tutti i file da estrarne. L'argomento commento può essere una null stringa.
Sintassi
SCCRTN SccCheckout (
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* 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 del controllo del codice sorgente può usare come elemento padre per qualsiasi finestra di dialogo fornita.
nFiles
[in] Numero di file selezionati per l'estrazione.
lpFileNames
[in] Matrice di nomi di percorso locali completi dei file da estrazione.
lpComment
[in] Commento da applicare a ogni file selezionato estratto.
fOptions
[in] Flag di comando (vedere Bitflags usati da comandi specifici).
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 | Check out ha avuto esito positivo. |
| 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_NOTAUTHORIZED | L'utente non è autorizzato a eseguire questa operazione. |
| SCC_E_NONSPECIFICERROR | Errore non specifico. Il file non è stato estratto. |
| SCC_E_ALREADYCHECKEDOUT | L'utente ha già estratto il file. |
| SCC_E_FILEISLOCKED | Il file è bloccato, vietando la creazione di nuove versioni. |
| SCC_E_FILEOUTEXCLUSIVE | Un altro utente ha eseguito un'estrazione esclusiva su questo file. |
| SCC_I_OPERATIONCANCELED | L'operazione è stata annullata prima del completamento. |