Funzione SccHistory
Questa funzione visualizza la cronologia dei file specificati.
Sintassi
SCCRTN SccHistory(
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* lpFileNames,
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 specificati nella lpFileName matrice.
lpFileName
[in] Matrice di nomi completi di file.
fOptions
[in] Flag di comando (attualmente non usati).
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 | La cronologia delle versioni è stata ottenuta correttamente. |
| SCC_I_RELOADFILE | Il sistema di controllo del codice sorgente ha effettivamente modificato il file su disco durante il recupero della cronologia (ad esempio, ottenendo una versione precedente di esso), quindi l'IDE deve ricaricare questo file. |
| SCC_E_FILENOTCONTROLLED | Il file non è sotto il controllo del codice sorgente. |
| SCC_E_OPNOTSUPPORTED | Il sistema di controllo del codice sorgente non supporta questa operazione. |
| SCC_E_NOTAUTHORIZED | L'utente non è autorizzato a eseguire 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_PROJNOTOPEN | Il progetto non è stato aperto. |
| SCC_E_NONSPECIFICERROR | Errore non specifico. Impossibile ottenere la cronologia dei file. |
Osservazioni:
Il plug-in del controllo del codice sorgente può visualizzare la propria finestra di dialogo per visualizzare la cronologia di ogni file, usando hWnd come finestra padre. In alternativa, è possibile usare la funzione di callback di output di testo facoltativa fornita a SccOpenProject , se supportata.
Si noti che in determinate circostanze, il file esaminato può cambiare durante l'esecuzione di questa chiamata. Ad esempio, il comando Visual Source Cassaforte history consente all'utente di ottenere una versione precedente del file. In tal caso, il plug-in del controllo del codice sorgente restituisce SCC_I_RELOAD un avviso all'IDE che deve ricaricare il file.
Nota
Se il plug-in del controllo del codice sorgente non supporta questa funzione per una matrice di file, è possibile visualizzare solo la cronologia dei file per il primo file.