Aracılığıyla paylaş

SccPopulateList İşlevi

Bu işlev, belirli bir kaynak denetimi komutu için dosyaların listesini güncelleştirir ve verilen tüm dosyalara kaynak denetimi durumu sağlar.

Sözdizimi

SCCRTN SccPopulateList (
   LPVOID          pvContext,
   enum SCCCOMMAND nCommand,
   LONG            nFiles,
   LPCSTR*         lpFileNames,
   POPLISTFUNC     pfnPopulate,
   LPVOID          pvCallerData,
   LPLONG          lpStatus,
   LONG            fOptions
);

Parametreler

pvContext

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

nKomand

[in] Dizideki lpFileNames tüm dosyalara uygulanacak kaynak denetimi komutu (olası komutların listesi için bkz . Komut Kodu ).

nFiles

[in] Dizideki lpFileNames dosya sayısı.

lpFileNames

[in] IDE tarafından bilinen dosya adları dizisi.

pfnPopulate

[in] Dosya eklemek ve kaldırmak için çağrı yapmak için IDE geri çağırma işlevi (ayrıntılar için poplistFUNC bölümüne bakın).

pvCallerData

[in] Geri çağırma işlevine değiştirilmeden geçirilecek değer.

lpStatus

[in, out] Her dosyanın durum bayraklarını döndürmek için kaynak denetimi eklentisine yönelik bir dizi.

fOptions

[in] Komut bayrakları (ayrıntılar için Belirli Komutlar Tarafından Kullanılan BitFlags'ın "PopulateList bayrağı" bölümüne bakın).

İade Değeri

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

Value Açıklama
SCC_OK Başarılı.
SCC_E_NONSPECIFICERROR Özel olmayan hata.

Açıklamalar

Bu işlev, geçerli durumu için dosya listesini inceler. Bir dosya ölçütüyle eşleşmediğinde çağıranı bilgilendirmek için nCommandgeri çağırma işlevini kullanırpfnPopulate. Örneğin, komut ise SCC_COMMAND_CHECKIN ve listedeki bir dosya kullanıma alınmamışsa, çağıranı bilgilendirmek için geri arama kullanılır. Bazen, kaynak denetimi eklentisi komutun parçası olabilecek diğer dosyaları bulabilir ve bunları ekleyebilir. Bu, örneğin bir Visual Basic kullanıcısının kendi projesi tarafından kullanılan ancak Visual Basic proje dosyasında görünmeyen bir .bmp dosyasını kullanıma almalarına olanak tanır. Kullanıcı IDE'de Al komutunu seçer. IDE, kullanıcının alabileceğini düşündüğü tüm dosyaların listesini görüntüler, ancak liste gösterilmeden önce, SccPopulateList görüntülenecek listenin güncel olduğundan emin olmak için işlev çağrılır.

Örnek

IDE, kullanıcının alabileceğini düşündüğü dosyaların listesini oluşturur. Bu listeyi görüntülemeden önce işlevi çağırır SccPopulateList ve kaynak denetimi eklentisine listeden dosya ekleme ve silme fırsatı verir. Eklenti, verilen geri çağırma işlevini çağırarak listeyi değiştirir (daha fazla ayrıntı için bkz . POPLISTFUNC ).

Eklenti, tamamlanana ve işlevden dönene kadar dosyaları ekleyip silen işlevi çağırmaya pfnPopulate SccPopulateList devam eder. IDE daha sonra listesini görüntüleyebilir. dizi, lpStatus IDE tarafından geçirilen özgün listedeki tüm dosyaları temsil eder. Eklenti, geri çağırma işlevini kullanmaya ek olarak tüm bu dosyaların durumunu doldurur.

Not

Kaynak denetimi eklentisi her zaman bu işlevden hemen dönme ve listeyi olduğu gibi bırakma seçeneğine sahiptir. Bir eklenti bu işlevi uygularsa, SccInitialize'a ilk çağrıda bitflag özelliğini ayarlayarak SCC_CAP_POPULATELIST bunu gösterebilir. Varsayılan olarak, eklenti her zaman geçirilen tüm öğelerin dosyalar olduğunu varsaymalıdır. Ancak, IDE parametresinde SCC_PL_DIR fOptions bayrağı ayarlarsa, geçirilen tüm öğeler dizin olarak kabul edilir. Eklenti, dizinlere ait tüm dosyaları eklemelidir. IDE hiçbir zaman dosya ve dizinlerin bir karışımını geçirmez.

Ayrıca bkz.

  • Last updated on