Udostępnij za pośrednictwem

SccRunScc, funkcja

  • Artykuł

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).

Zobacz też