Share via

SccHistory, funkcja

  • Artykuł

Ta funkcja wyświetla historię określonych plików.

Składnia

SCCRTN SccHistory(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LONG      fOptions,
   LPCMDOPTS pvOptions
);

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

lpFileName

[in] Tablica w pełni kwalifikowanych nazw plików.

fOptions

[in] Flagi poleceń (obecnie nie są używane).

pvOptions

[in] Opcje specyficzne dla wtyczki kontroli źródła.

Wartość zwracana

Implementacja wtyczki kontroli źródła tej funkcji powinna zwrócić jedną z następujących wartości:

Wartość Opis
SCC_OK Historia wersji została pomyślnie uzyskana.
SCC_I_RELOADFILE System kontroli źródła zmodyfikował plik na dysku podczas pobierania historii (na przykład przez pobranie starej wersji), więc środowisko IDE powinno ponownie załadować ten plik.
SCC_E_FILENOTCONTROLLED Plik nie jest pod kontrolą źródła.
SCC_E_OPNOTSUPPORTED System kontroli źródła nie obsługuje tej operacji.
SCC_E_NOTAUTHORIZED Użytkownik nie może wykonać tej operacji.
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ą. Zalecane jest ponowienie próby.
SCC_E_PROJNOTOPEN Projekt nie został otwarty.
SCC_E_NONSPECIFICERROR Niepowodzeń nieokreślonych. Nie można uzyskać historii plików.

Uwagi

Wtyczka kontroli źródła może wyświetlić własne okno dialogowe, aby wyświetlić historię każdego pliku, używając hWnd jako okna nadrzędnego. Alternatywnie można użyć opcjonalnej funkcji wywołania zwrotnego danych wyjściowych tekstu dostarczonej do SccOpenProject , jeśli jest obsługiwana.

Należy pamiętać, że w pewnych okolicznościach badane pliki mogą ulec zmianie podczas wykonywania tego wywołania. Na przykład polecenie Visual Source Sejf history daje użytkownikowi szansę uzyskania starej wersji pliku. W takim przypadku wtyczka kontroli źródła zwraca SCC_I_RELOAD ostrzeżenie ide, że musi ponownie załadować plik.

Uwaga

Jeśli wtyczka kontroli źródła nie obsługuje tej funkcji dla tablicy plików, można wyświetlić tylko historię plików dla pierwszego pliku.

Zobacz też