SccDirQueryInfo, funkcja
Ta funkcja sprawdza listę w pełni kwalifikowanych katalogów pod kątem bieżącego stanu.
Składnia
SCCRTN SccDirQueryInfo(
LPVOID pContext,
LONG nDirs,
LPCSTR* lpDirNames,
LPLONG lpStatus
);
Parametry
Pcontext
[in] Struktura kontekstu wtyczki kontroli źródła.
nDirs
[in] Liczba katalogów wybranych do odpytowania.
lpDirNames
[in] Tablica w pełni kwalifikowanych ścieżek katalogów do odpytowania.
lpStatus
[in, out] Struktura tablicy wtyczki kontroli źródła w celu zwrócenia flag stanu (zobacz Kod stanu katalogu, aby uzyskać szczegółowe informacje).
Wartość zwracana
Implementacja wtyczki kontroli źródła tej funkcji powinna zwrócić jedną z następujących wartości:
| Wartość | Opis |
|---|---|
| SCC_OK | Zapytanie zakończyło się pomyślnie. |
| SCC_E_OPNOTSUPPORTED | System kontroli kodu źródłowego nie obsługuje 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_NONSPECIFICERROR SCC_E_UNKNOWNERROR |
Niepowodzeń nieokreślonych. |
Uwagi
Funkcja wypełnia tablicę zwracaną maską bitów z SCC_DIRSTATUS rodziny (zobacz Kod stanu katalogu), jednym wpisem dla każdego katalogu. Tablica stanu jest przydzielana przez obiekt wywołujący.
Środowisko IDE używa tej funkcji przed zmianą nazwy katalogu, aby sprawdzić, czy katalog jest pod kontrolą źródła, wysyłając zapytanie o to, czy ma odpowiedni projekt. Jeśli katalog nie jest pod kontrolą źródła, środowisko IDE może dostarczyć użytkownikowi odpowiednie ostrzeżenie.
Uwaga
Jeśli wtyczka kontroli źródła zdecyduje się nie implementować co najmniej jednej wartości stanu, nieimplementowane bity powinny być ustawione na zero.