Funzione SccRunScc

  • Articolo

Questa funzione richiama lo strumento di amministrazione del controllo del codice sorgente.

Sintassi

SCCRTN SccRunScc(
   LPVOID  pvContext,
   HWND    hWnd,
   LONG    nFiles,
   LPCSTR* lpFileNames
);

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 lpFileNames matrice.

lpFileNames

[in] Matrice di nomi di file selezionati.

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 Lo strumento di amministrazione del controllo del codice sorgente è stato richiamato correttamente.
SCC_I_OPERATIONCANCELED L'operazione è stata annullata.
SCC_E_INITIALIZEFAILED Impossibile inizializzare il sistema di 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.
SCC_E_CONNECTIONFAILURE Impossibile connettersi al sistema di controllo del codice sorgente.
SCC_E_FILENOTCONTROLLED Il file selezionato non è sotto il controllo del codice sorgente.
SCC_E_NONSPECIFICERROR Errore non specifico.

Osservazioni:

Questa funzione consente al chiamante di accedere alla gamma completa di funzionalità del sistema di controllo del codice sorgente tramite uno strumento di amministrazione esterno. Se il sistema di controllo del codice sorgente non dispone di interfaccia utente, il plug-in del controllo del codice sorgente può implementare un'interfaccia per eseguire le funzioni di amministrazione necessarie.

Questa funzione viene chiamata con un conteggio e una matrice di nomi di file per i file attualmente selezionati. Se lo strumento di amministrazione lo supporta, l'elenco dei file può essere usato per preselezionare i file nell'interfaccia di amministrazione; in caso contrario, l'elenco può essere ignorato.

Questa funzione viene in genere richiamata quando l'utente seleziona launch <source control server> dal menu File ->Source Control. Questa opzione di menu Avvia può essere sempre disabilitata o anche nascosta impostando una voce del Registro di sistema. Per informazioni dettagliate, vedere Procedura: Installare un plug-in del controllo del codice sorgente. Questa funzione viene chiamata solo se SccInitialize restituisce il SCC_CAP_RUNSCC bit di funzionalità (vedere Flag di funzionalità per informazioni dettagliate su questo e altri bit di funzionalità).

Vedi anche