SccQueryInfo İşlevi

Bu işlev, kaynak denetimi altındaki seçili dosyalar kümesi için durum bilgilerini alır.

Sözdizimi

SCCRTN SccQueryInfo(
   LPVOID  pvContext,
   LONG    nFiles,
   LPCSTR* lpFileNames,
   LPLONG  lpStatus
);

Parametreler

pvContext

[in] Kaynak denetimi eklentisi bağlam yapısı.

nFiles

[in] Dizide lpFileNames belirtilen dosya sayısı ve dizinin uzunluğu lpStatus .

lpFileNames

[in] Sorgulanacak dosya adları dizisi.

lpStatus

[in, out] Kaynak denetimi eklentisinin her dosya için durum bayraklarını döndürdüğü bir dizi. Daha fazla bilgi için bkz . Dosya Durum Kodu.

İade Değeri

Bu işlevin kaynak denetimi eklentisinin aşağıdaki değerlerden birini döndürmesi beklenir:

Value	Açıklama
SCC_OK	Sorgu başarılı oldu.
SCC_E_ACCESSFAILURE	Kaynak denetim sistemine erişirken büyük olasılıkla ağ veya çekişme sorunlarından kaynaklanan bir sorun oluştu. Yeniden deneme önerilir.
SCC_E_PROJNOTOPEN	Proje kaynak denetimi altında açık değil.
SCC_E_NONSPECIFICERROR	Özel olmayan hata.

Açıklamalar

Boş bir dizeyse lpFileName , şu anda güncelleştirilecek durum bilgisi yoktur. Aksi takdirde, durum bilgilerinin değiştirildiği dosyanın tam yol adıdır.

Dönüş dizisi bit maskesi SCC_STATUS_xxxx olabilir. Daha fazla bilgi için bkz . Dosya Durum Kodu. Kaynak denetim sistemi tüm bit türlerini desteklemeyebilir. Örneğin, teklif edilmediyse SCC_STATUS_OUTOFDATE , bit ayarlanmamıştır.

Dosyaları kullanıma almak için bu işlevi kullanırken aşağıdaki MSSCCI durum gereksinimlerini not edin:

• SCC_STATUS_OUTBYUSER , geçerli kullanıcı dosyayı kullanıma aldığı zaman ayarlanır.

• SCC_STATUS_CHECKEDOUT ayarlanmadığı sürece SCC_STATUS_OUTBYUSER ayarlanamaz.

• SCC_STATUS_CHECKEDOUT yalnızca dosya belirlenen çalışma dizininde kullanıma alındığında ayarlanır.

• Dosya geçerli kullanıcı tarafından çalışma SCC_STATUS_OUTBYUSER dizini dışında bir dizinde kullanıma alınmışsa ayarlanır ancak SCC_STATUS_CHECKEDOUT ayarlanmaz.

Ayrıca bkz.

• Kaynak Denetimi Eklentisi API İşlevleri
• Dosya Durumu Kodu