Aracılığıyla paylaş

SccSetOption İşlevi

Bu işlev, kaynak denetimi eklentisinin davranışını denetleye seçenekleri ayarlar.

Sözdizimi

SCCRTN SccSetOption(
   LPVOID pvContext,
   LONG   nOption,
   LONG   dwVal
);

Parametreler

pvContext

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

nOption

[in] Ayarlanan seçenek.

dwVal

[in] Seçeneğin ayarları.

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 Seçenek başarıyla ayarlandı.
SCC_I_SHARESUBPROJOK döndürüldüyse nOption SCC_OPT_SHARESUBPROJ ve kaynak denetimi eklentisi IDE'nin hedef klasörü ayarlamasına izin verir.
SCC_E_OPNOTSUPPORTED Seçenek ayarlanmadı ve buna bağlı olmamalıdır.

Açıklamalar

IDE, kaynak denetimi eklentisinin davranışını denetlemek için bu işlevi çağırır. İlk parametre olan nOption, ayarlanan değeri, ikinci dwValparametresi ise bu değerle ne yapacağını gösterir. Eklenti, ile pvContext``, ilişkili bu bilgileri depolar, bu nedenle IDE'nin SccInitialize'ı çağırdıktan sonra bu işlevi çağırması gerekir (ancak her SccOpenProject çağrısından sonra olması gerekmez).

Seçeneklerin ve değerlerinin özeti:

nOption dwValue Açıklama
SCC_OPT_EVENTQUEUE SCC_OPT_EQ_DISABLE

SCC_OPT_EQ_ENABLE		 Arka plan olayı kuyruğa alma özelliğini etkinleştirir/devre dışı bırakır.
SCC_OPT_USERDATA Rastgele değer OPTNAMECHANGEPFN geri çağırma işlevine geçirilecek kullanıcı değerini belirtir.
SCC_OPT_HASCANCELMODE SCC_OPT_HCM_NO

SCC_OPT_HCM_YES		 IDE'nin şu anda bir işlemi iptal etme işlemini destekleyip desteklemediğini gösterir.
SCC_OPT_NAMECHANGEPFN OPTNAMECHANGEPFN geri çağırma işlevinin işaretçisi Bir ad değiştirme geri çağırma işlevine bir işaretçi ayarlar.
SCC_OPT_SCCCHECKOUTONLY SCC_OPT_SCO_NO

SCC_OPT_SCO_YES		 IDE'nin dosyalarının el ile kullanıma alınmasına izin verip vermediğini (kaynak denetimi kullanıcı arabirimi aracılığıyla) veya yalnızca kaynak denetimi eklentisi aracılığıyla kullanıma alınması gerekip gerekmediğini gösterir.
SCC_OPT_SHARESUBPROJ Yok Kaynak denetimi eklentisi IDE'nin yerel proje klasörünü belirtmesine izin veriyorsa, eklenti döndürür SCC_I_SHARESUBPROJOK.

SCC_OPT_EVENTQUEUE

ise nOption SCC_OPT_EVENTQUEUE, IDE arka plan işlemeyi devre dışı bırakır (veya yeniden etkinleştirir). Örneğin, derleme sırasında IDE, kaynak denetimi eklentisine herhangi bir türde boşta işlemeyi durdurmasını isteyebilir. Derlemeden sonra eklentinin olay kuyruğunun güncel kalmasını sağlamak için arka plan işlemeyi yeniden etkinleştirir. SCC_OPT_EVENTQUEUE değerine nOptionkarşılık gelen ve için dwValSCC_OPT_EQ_ENABLE SCC_OPT_EQ_DISABLEiki olası değer vardır.

SCC_OPT_HASCANCELMODE

değeri nOption ise SCC_OPT_HASCANCELMODE, IDE kullanıcıların uzun işlemleri iptal etmesine izin verir. SCC_OPT_HCM_NO ayarı dwVal (varsayılan) ayarı, IDE'nin iptal moduna sahip olmadığını gösterir. Kaynak denetimi eklentisi, kullanıcının iptal edebilmesini istiyorsa kendi İptal düğmesini sunmalıdır. SCC_OPT_HCM_YES IDE'nin bir işlemi iptal etme olanağı sağladığını gösterir, bu nedenle SCC eklentisinin kendi İptal düğmesini görüntülemesi gerekmez. IDE olarak ayarlanırsa dwVal SCC_OPT_HCM_YES, yanıt vermeye SCC_MSG_STATUS ve DOCANCEL geri çağırma işlevine gönderilen iletilere lpTextOutProc hazır olur (bkz . LPTEXTOUTPROC). IDE bu değişkeni ayarlamazsa, eklenti bu iki iletiyi göndermemelidir.

SCC_OPT_NAMECHANGEPFN

nOption olarak ayarlanırsa SCC_OPT_NAMECHANGEPFNve hem kaynak denetimi eklentisi hem de IDE buna izin verirse, eklenti bir kaynak denetimi işlemi sırasında bir dosyayı yeniden adlandırabilir veya taşıyabilir. , dwVal OPTNAMECHANGEPFN türünde bir işlev işaretçisine ayarlanır. Bir kaynak denetimi işlemi sırasında eklenti, üç parametre geçirerek bu işlevi çağırabilir. Bunlar, bir dosyanın eski adı (tam yolu olan), bu dosyanın yeni adı (tam yolu olan) ve IDE ile ilgisi olan bilgilerin işaretçisidir. IDE, bu son işaretçiyi, veriye dwVal SCC_OPT_USERDATAişaret eden set ile nOption çağrısı SccSetOption yaparak gönderir. Bu işlev için destek isteğe bağlıdır. Bu özelliği kullanan bir VSSCI eklentisi, işlev işaretçisini ve kullanıcı veri değişkenlerini olarak NULLbaşlatmalı ve verilmediği sürece yeniden adlandırma işlevini çağırmamalıdır. Ayrıca, verilen değeri tutmaya veya yeni SccSetOptionçağrısına yanıt olarak değiştirmeye hazır olmalıdır. Bu, bir kaynak denetimi komut işleminin ortasında gerçekleşmez, ancak komutlar arasında gerçekleşebilir.

SCC_OPT_SCCCHECKOUTONLY

nOption olarak ayarlanırsa SCC_OPT_SCCCHECKOUTONLY, IDE açık olan projedeki dosyaların hiçbir zaman kaynak denetim sisteminin kullanıcı arabirimi aracılığıyla el ile kullanıma alınmaması gerektiğini belirtir. Bunun yerine, dosyalar yalnızca IDE denetimi altındaki kaynak denetimi eklentisi aracılığıyla kullanıma alınmalıdır. olarak ayarlanırsa dwValue SCC_OPT_SCO_NO, dosyaların eklenti tarafından normal şekilde ele alınması gerektiği ve kaynak denetim kullanıcı arabirimi aracılığıyla kullanıma alınabileceği anlamına gelir. olarak ayarlanırsa dwValue SCC_OPT_SCO_YESyalnızca eklentinin dosyaları kullanıma almasına izin verilir ve kaynak denetim sisteminin kullanıcı arabirimi çağrılmamalıdır. Bu, IDE'nin yalnızca IDE aracılığıyla kullanıma almak için anlamlı olan "sahte dosyalara" sahip olabileceği durumlar içindir.

SCC_OPT_SHARESUBPROJ

olarak ayarlanırsa nOption SCC_OPT_SHARESUBPROJ, IDE kaynak denetimi eklentisinin kaynak denetiminden dosya eklerken belirtilen yerel klasörü kullanıp kullanamayacağını test etmektir. Parametresinin dwVal değeri bu durumda önemli değildir. Eklenti, SccAddFromScc çağrıldığında IDE'nin dosyaların kaynak denetiminden eklendiği yerel hedef klasörü belirtmesine izin veriyorsa, işlev çağrıldığında eklentinin SccSetOption döndürülmesi SCC_I_SHARESUBPROJOK gerekir. IDE daha sonra işlevin lplpFileNames SccAddFromScc parametresini kullanarak hedef klasöre geçirir. Eklenti, kaynak denetiminden eklenen dosyaları yerleştirmek için bu hedef klasörü kullanır. Seçenek ayarlandığında eklenti döndürülmezse SCC_I_SHARESUBPROJOK SCC_OPT_SHARESUBPROJ , IDE eklentinin yalnızca geçerli yerel klasöre dosya ekleyebileceği varsayılır.

Ayrıca bkz.

  • Last updated on