SccGetEvents işlevi

Bu işlev kuyruğa alınmış bir durum olayı alır.

Sözdizimi

SCCRTN SccGetEvents (
   LPVOID pvContext,
   LPSTR  lpFileName,
   LPLONG lpStatus,
   LPLONG pnEventsRemaining
);

Parametreler

pvContext

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

lpFileName

[in, out] Kaynak denetimi eklentisinin döndürülen dosya adını (_MAX_PATH karaktere kadar) yerleştirdiği arabellek.

lpStatus

[in, out] Durum kodunu döndürür (olası değerler için bkz . Dosya durum kodu ).

pnEventsRemaining

[in, out] Bu çağrıdan sonra kuyrukta kalan girdilerin sayısını döndürür. Bu numara büyükse, arayan tüm bilgileri aynı anda almak için SccQueryInfo çağrısı yapmaya karar verebilir.

Dönüş değeri

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

Value	Açıklama
SCC_OK	Olayları alma başarılı oldu.
SCC_E_OPNOTSUPPORTED	Bu işlev desteklenmez.
SCC_E_NONSPECIFICERROR	Özel olmayan hata.

Açıklamalar

Bu işlev, kaynak denetimi altındaki dosyalar için herhangi bir durum güncelleştirmesi olup olmadığını görmek için boşta işleme sırasında çağrılır. Kaynak denetimi eklentisi, bildiği tüm dosyaların durumunu korur ve eklenti tarafından durum değişikliği her belirtildiğinde, durum ve ilişkili dosya bir kuyrukta depolanır. Çağrıldığında SccGetEvents kuyruğun en üst öğesi alınır ve döndürülür. Bu işlev yalnızca daha önce önbelleğe alınmış bilgileri döndürecek şekilde kısıtlanmıştır ve çok hızlı bir geri dönüşe sahip olmalıdır (yani, disk okunmamalıdır veya kaynak denetim sisteminden durum istenmemelidir); aksi takdirde IDE'nin performansı azalmaya başlayabilir.

Raporlanan bir durum güncelleştirmesi yoksa, kaynak denetimi eklentisi tarafından lpFileNameişaret edilen arabellekte boş bir dize depolar. Aksi takdirde, eklenti durum bilgilerinin değiştirildiği dosyanın tam yol adını depolar ve uygun durum kodunu döndürür (Dosya durum kodunda ayrıntıları verilen değerlerden biri).

Ayrıca bkz.

• Kaynak denetimi eklentisi API işlevleri
• Dosya durum kodu