Funzione SccDirDiff
Questa funzione visualizza le differenze tra la directory locale corrente sul disco client e il progetto corrispondente nel controllo del codice sorgente.
Sintassi
SCCRTN SccDirDiff(
LPVOID pContext,
HWND hWnd,
LPCSTR lpDirName,
LONG dwFlags,
LPCMDOPTS pvOptions
);
Parametri
pContext
[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.
lpDirName
[in] Percorso completo della directory locale per cui mostrare una differenza visiva.
dwFlags
[in] Flag di comando (vedere la sezione Osservazioni).
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 directory su disco corrisponde al progetto nel controllo del codice sorgente. |
| SCC_I_FILESDIFFER | La directory su disco è diversa dal progetto nel controllo del codice sorgente. |
| SCC_I_RELOADFILE | È necessario ricaricare un file o un progetto. |
| SCC_E_FILENOTCONTROLLED | La directory non è sotto il controllo del codice sorgente. |
| 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_NONSPECIFICERROR SCC_E_UNKNOWNERROR |
Errore non specifico. |
| SCC_E_FILENOTEXIST | Impossibile trovare la directory locale. |
Osservazioni:
Questa funzione viene usata per indicare al plug-in del controllo del codice sorgente di visualizzare all'utente un elenco di modifiche apportate a una directory specificata. Il plug-in apre la propria finestra, in un formato di propria scelta, per visualizzare le differenze tra la directory dell'utente su disco e il progetto corrispondente sotto il controllo della versione.
Se un plug-in supporta il confronto delle directory, deve supportare il confronto delle directory in base al nome di file anche se le opzioni "quick-diff" non sono supportate.
dwFlags |
Interpretazione |
|---|---|
| SCC_DIFF_IGNORECAedizione Standard | Confronto senza distinzione tra maiuscole e minuscole (può essere usato per un oggetto visivo o diff rapido). |
| SCC_DIFF_IGNORESPACE | Ignora gli spazi vuoti (può essere usato per gli oggetti visivi o diff rapidi). |
| SCC_DIFF_QD_CONTENTS | Se supportato dal plug-in del controllo del codice sorgente, confronta automaticamente la directory, byte byte. |
| SCC_DIFF_QD_CHECKSUM | Se supportato dal plug-in, confronta automaticamente la directory tramite un checksum o, se non supportato, esegue il fallback a SCC_DIFF_QD_CONTENTS. |
| SCC_DIFF_QD_TIME | Se supportato dal plug-in, confronta automaticamente la directory tramite il timestamp o, se non supportato, esegue il fallback su SCC_DIFF_QD_CHECKSUM o SCC_DIFF_QD_CONTENTS. |
Nota
Questa funzione usa gli stessi flag di comando di SccDiff. Tuttavia, un plug-in del controllo del codice sorgente può scegliere di non supportare l'operazione "quick-diff" per le directory.