Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Bu işlev, kaynak denetimi eklentisini başlatır ve tümleşik geliştirme ortamına (IDE) yönelik özellikler ve sınırlar sağlar.
Sözdizimi
SCCRTN SccInitialize (
LPVOID* ppvContext,
HWND hWnd,
LPCSTR lpCallerName,
LPSTR lpSccName,
LPLONG lpSccCaps,
LPSTR lpAuxPathLabel,
LPLONG pnCheckoutCommentLen,
LPLONG pnCommentLen
);
Parametreler
ppvContext
[in] Kaynak denetimi eklentisi, bağlam yapısına yönelik bir işaretçiyi buraya yerleştirebilir.
hWnd
[in] Kaynak denetimi eklentisinin sağladığı iletişim kutuları için üst öğe olarak kullanabileceği IDE penceresinin tanıtıcısı.
lpCallerName
[in] Kaynak denetimi eklentisini çağıran programın adı.
lpSccName
[in, out] Kaynak denetimi eklentisinin kendi adını yerleştirdiği arabellek (aşmamak SCC_NAME_LENiçin).
lpSccCaps
[out] Kaynak denetimi eklentisinin yetenek bayraklarını döndürür.
lpAuxPathLabel
[in, out] Kaynak denetimi eklentisinin SccOpenProject ve SccGetProjPath tarafından döndürülen parametreyi açıklayan lpAuxProjPath bir dize yerleştirdiği arabellek (aşmamak SCC_AUXLABEL_LENiçin).
pnCheckoutCommentLen
[out] Bir kullanıma alma açıklaması için izin verilen uzunluk üst sınırını döndürür.
pnCommentLen
[out] Diğer açıklamalar için izin verilen uzunluk üst sınırını döndürür.
İade Değeri
Bu işlevin kaynak denetimi eklentisinin aşağıdaki değerlerden birini döndürmesi beklenir:
| Value | Açıklama |
|---|---|
| SCC_OK | Kaynak denetimi başlatma başarılı oldu. |
| SCC_E_INITIALIZEFAILED | Sistem başlatılamadı. |
| SCC_E_NOTAUTHORIZED | Kullanıcının belirtilen işlemi gerçekleştirmesine izin verilmiyor. |
| SCC_E_NONSPECFICERROR | Özel olmayan hata; kaynak denetim sistemi başlatılmadı. |
Açıklamalar
IDE, kaynak denetimi eklentisini ilk kez yüklediğinde bu işlevi çağırır. IDE'nin çağıranın adı gibi belirli bilgileri eklentiye geçirmesini sağlar. IDE ayrıca açıklamalar için izin verilen maksimum uzunluk ve eklentinin özellikleri gibi belirli bilgileri de geri alır.
İşaretçiyi ppvContext gösterir NULL . Kaynak denetimi eklentisi kendi kullanımı için bir yapı ayırabilir ve bu yapıya yönelik bir işaretçiyi içinde ppvContextdepolayabilir. IDE bu işaretçiyi diğer tüm VSSCI API işlevlerine geçirerek eklentinin genel depolamaya başvurmadan bağlam bilgilerine sahip olmasını ve eklentinin birden çok örneğini desteklemesini sağlar. SccUninitialize çağrıldığında bu yapı serbest bırakılmalıdır.
lpCallerName ve lpSccName parametreleri, exchange adlarına IDE ve kaynak denetimi eklentisini etkinleştirir. Bu adlar yalnızca birden çok örneği ayırt etmek için kullanılabilir veya aslında menülerde veya iletişim kutularında görünebilir.
lpAuxPathLabel parametresi, çözüm dosyasında depolanan ve SccOpenProject çağrısında kaynak denetimi eklentisine geçirilen yardımcı proje yolunu tanımlamak için açıklama olarak kullanılan bir dizedir. Görsel Kaynak Kasa "Source Kasa Project:" dizesini kullanır; diğer kaynak denetimi eklentileri bu dizeyi kullanmaktan kaçınmalıdır.
lpSccCaps parametresi, kaynak denetimi eklentisine eklentinin yeteneklerini gösteren bitflag'ları depolamak için bir yer sağlar. (Yetenek bitflag'larının tam listesi için bkz. Yetenek Bayrakları). Örneğin, eklenti sonuçları çağıran tarafından sağlanan bir geri çağırma işlevine yazmayı planlıyorsa, eklenti özellik biti SCC_CAP_TEXTOUT ayarlar. Bu, IDE'ye sürüm denetimi sonuçları için bir pencere oluşturması için sinyal gönderir.