Bitflags używane przez określone polecenia
Zachowanie wielu funkcji w interfejsie API wtyczki kontroli źródła można zmodyfikować, ustawiając co najmniej jeden bit w jednej wartości. Te wartości są znane jako bitflags. Różne bitflags używane przez interfejs API wtyczki kontroli źródła są szczegółowo opisane w tym miejscu, pogrupowane według funkcji, która ich używa.
Flaga wyewidencjonowana
Tę flagę można ustawić dla SccAdd lub SccCheckin.
| Flaga | Wartość | Opis |
|---|---|---|
SCC_KEEP_CHECKEDOUT |
0x1000 | Zachowaj wyewidencjonowany plik. |
Dodawanie flag
Te flagi są używane przez SccAdd.
| Flaga | Wartość | Opis |
|---|---|---|
SCC_FILETYPE_AUTO |
0x00 | Wtyczka kontroli źródła ma automatycznie wykryć, czy plik jest tekstowy, czy binarny. |
SCC_FILETYPE_TEXT |
0x01 | Typ pliku to tekst. |
SCC_FILETYPE_BINARY |
0x04 | Typ pliku jest binarny. Uwaga: SCC_FILETYPE_TEXT flagi i SCC_FILETYPE_BINARY wzajemnie się wykluczają. Ustaw dokładnie jedno lub nie. |
SCC_ADD_STORELATEST |
0x02 | Przechowuj tylko najnowszą wersję (bez różnic). |
Flagi różnic
SccDiff używa tych flag do zdefiniowania zakresu operacji różnic. Flagi SCC_DIFF_QD_xxx wzajemnie się wykluczają. Jeśli zostanie określona żadna z nich, nie zostanie podana żadna opinia wizualna. W przypadku "szybkiej różnicy" (QD) wtyczka nie określa, jak plik jest inny, tylko wtedy, gdy jest inny. Jeśli żadna z tych flag nie zostanie określona, zostanie wykonana "różnica wizualna"; szczegółowe różnice w plikach są obliczane i wyświetlane. Jeśli żądany QD nie jest obsługiwany, wtyczka zostanie przeniesiona do następnego najlepszego. Jeśli na przykład środowisko IDE żąda sumy kontrolnej, a wtyczka nie obsługuje jej, wtyczka wykonuje sprawdzanie pełnej zawartości (nadal znacznie szybciej niż w przypadku wyświetlania wizualizacji).
| Flaga | Wartość | Opis |
|---|---|---|
SCC_DIFF_IGNORECASE |
0x0002 | Ignoruj różnice wielkości liter. |
SCC_DIFF_IGNORESPACE |
0x0004 | Ignoruj różnice odstępów. Uwaga: SCC_DIFF_IGNORECASE flagi i SCC_DIFF_IGNORESPACE są opcjonalnymi opóźnieniami bitów. |
SCC_DIFF_QD_CONTENTS |
0x0010 | Funkcja QD przez porównanie całej zawartości pliku. |
SCC_DIFF_QD_CHECKSUM |
0x0020 | Funkcja QD według sumy kontrolnej. |
SCC_DIFF_QD_TIME |
0x0040 | Funkcja QD według sygnatury daty/godziny pliku. |
SCC_DIFF_QUICK_DIFF |
0x0070 | Jest to maska używana do sprawdzania wszystkich bitów QD. Nie należy przekazywać go do funkcji; trzy bity QD wzajemnie się wykluczają. Funkcja QD zawsze nie oznacza wyświetlania interfejsu użytkownika. |
Flaga WypełnijList
Ta flaga jest używana przez element SccPopulateList w parametrze fOptions .
| Flaga | Wartość | Opis |
|---|---|---|
SCC_PL_DIR |
0x00000001L | Środowisko IDE przekazuje katalogi, a nie pliki. |
Flagi PopulateDirList
Te flagi są używane przez SccPopulateDirList w parametrze fOptions .
| Wartość opcji | Wartość | Opis |
|---|---|---|
| SCC_PDL_ONELEVEL | 0x0000 | Sprawdź tylko jeden poziom katalogów dla katalogów (jest to ustawienie domyślne). |
| SCC_PDL_RECURSIVE | 0x0001 | Cyklicznie sprawdzaj wszystkie katalogi w każdym danym katalogu. |
| SCC_PDL_INCLUDEFILES | 0x0002 | Uwzględnij nazwy plików w procesie badania. |
Flagi OpenProject
Te flagi są używane przez SccOpenProject w parametrze dwFlags .
| Wartość opcji | Wartość | Opis |
|---|---|---|
| SCC_OP_CREATEIFNEW | 0x00000001L | Jeśli projekt nie istnieje w kontroli źródła, utwórz go. Jeśli ta flaga nie jest ustawiona, monituj użytkownika o utworzenie projektu (chyba że SCC_OP_SILENTOPEN określono flagę). |
| SCC_OP_SILENTOPEN | 0x00000002L | Nie monituj użytkownika o utworzenie projektu; wystarczy zwrócić wartość SCC_E_UNKNOWNPROJECT. |
Pobieranie flag
Te flagi są używane przez SccGet i SccCheckout.
| Flaga | Wartość | Opis |
|---|---|---|
SCC_GET_ALL |
0x00000001L | Środowisko IDE przekazuje katalogi, a nie pliki: Pobierz wszystkie pliki w tych katalogach. |
SCC_GET_RECURSIVE |
0x00000002L | Środowisko IDE przekazuje katalogi: pobierz te katalogi i wszystkie ich podkatalogi. |
nOption wartości
Te flagi są używane przez SccSetOption w parametrze nOption .
| Flaga | Wartość | Opis |
|---|---|---|
SCC_OPT_EVENTQUEUE |
0x00000001L | Ustaw stan kolejki zdarzeń. |
SCC_OPT_USERDATA |
0x00000002L | Określ dane użytkownika dla elementu SCC_OPT_NAMECHANGEPFN. |
SCC_OPT_HASCANCELMODE |
0x00000003L | Środowisko IDE może obsługiwać anulowanie. |
SCC_OPT_NAMECHANGEPFN |
0x00000004L | Ustaw wywołanie zwrotne dla zmian nazw. |
SCC_OPT_SCCCHECKOUTONLY |
0x00000005L | Wyłącz wyewidencjonowanie wtyczki kontroli źródła i nie ustawiaj katalogu roboczego. |
SCC_OPT_SHARESUBPROJ |
0x000000006L | Dodaj z systemu kontroli źródła, aby określić katalog roboczy. Spróbuj udostępnić go w skojarzonym projekcie, jeśli jest to bezpośredni element potomny. |
dwVal bitflags
Te flagi są używane przez SccSetOption w parametrze dwVal .
| Flaga | Wartość | Opis | Używane przez nOption wartość |
|---|---|---|---|
SCC_OPT_EQ_DISABLE |
0x00L | Zawiesza działanie kolejki zdarzeń. | SCC_OPT_EVENTQUEUE |
SCC_OPT_EQ_ENABLE |
0x01L | Włącza rejestrowanie kolejek zdarzeń. | SCC_OPT_EVENTQUEUE |
SCC_OPT_HCM_NO |
0L | (Ustawienie domyślne) Nie ma trybu anulowania; wtyczka musi być dostarczana w razie potrzeby. | SCC_OPT_HASCANCELMODE |
SCC_OPT_HCM_YES |
1L | Obsługa środowiska IDE anuluje. | SCC_OPT_HASCANCELMODE |
SCC_OPT_SCO_NO |
0L | (Ustawienie domyślne) OK, aby wyewidencjonować z poziomu interfejsu użytkownika wtyczki; katalog roboczy jest ustawiony. | SCC_OPT_SCCCHECKOUTONLY |
SCC_OPT_SCO_YES |
1L | Brak wyewidencjonowania interfejsu użytkownika wtyczki, bez katalogu roboczego. | SCC_OPT_SCCCHECKOUTONLY |