SccRunScc, funkcja
Ta funkcja wywołuje narzędzie administracyjne kontroli źródła.
Składnia
SCCRTN SccRunScc(
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* lpFileNames
);
Parametry
pvContext
[in] Struktura kontekstu wtyczki kontroli źródła.
Hwnd
[in] Dojście do okna środowiska IDE, którego wtyczka kontroli źródła może używać jako elementu nadrzędnego dla wszystkich okien dialogowych, które udostępnia.
nFiles
[in] Liczba plików określonych w tablicy lpFileNames .
lpFileNames
[in] Tablica wybranych nazw plików.
Wartość zwracana
Implementacja wtyczki kontroli źródła tej funkcji powinna zwrócić jedną z następujących wartości:
| Wartość | Opis |
|---|---|
| SCC_OK | Narzędzie administracji kontroli źródła zostało pomyślnie wywołane. |
| SCC_I_OPERATIONCANCELED | Operacja została anulowana. |
| SCC_E_INITIALIZEFAILED | Nie można zainicjować systemu kontroli źródła. |
| SCC_E_ACCESSFAILURE | Wystąpił problem podczas uzyskiwania dostępu do systemu kontroli źródła, prawdopodobnie z powodu problemów z siecią lub rywalizacją. |
| SCC_E_CONNECTIONFAILURE | Nie można nawiązać połączenia z systemem kontroli źródła. |
| SCC_E_FILENOTCONTROLLED | Wybrany plik nie jest pod kontrolą źródła. |
| SCC_E_NONSPECIFICERROR | Niepowodzeń nieokreślonych. |
Uwagi
Ta funkcja umożliwia obiektowi wywołującym dostęp do pełnego zakresu funkcji systemu kontroli źródła za pomocą zewnętrznego narzędzia administracyjnego. Jeśli system kontroli źródła nie ma interfejsu użytkownika, wtyczka kontroli źródła może zaimplementować interfejs do wykonywania niezbędnych funkcji administracyjnych.
Ta funkcja jest wywoływana z liczbą i tablicą nazw plików dla aktualnie wybranych plików. Jeśli narzędzie administracyjne go obsługuje, lista plików może służyć do wstępnego wybierania plików w interfejsie administracyjnym; w przeciwnym razie listę można zignorować.
Ta funkcja jest zwykle wywoływana, gdy użytkownik wybierze pozycję Uruchom <serwer> kontroli źródła z menu Plik ->Kontrola źródła . Ta opcja menu Uruchom może być zawsze wyłączona lub nawet ukryta, ustawiając wpis rejestru. Aby uzyskać szczegółowe informacje, zobacz Instrukcje: instalowanie wtyczki kontroli kodu źródłowego. Ta funkcja jest wywoływana tylko wtedy, gdy funkcja SccInitialize zwraca SCC_CAP_RUNSCC bit możliwości (zobacz Capability Flags ,aby uzyskać szczegółowe informacje na temat tego i innych bitów możliwości).