Udostępnij za pośrednictwem


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.

Zobacz też