Funzione SccHistory

  • Articolo

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.

Vedi anche