SccAdd işlevi

Bu işlev, kaynak denetim sistemine yeni dosyalar ekler.

Sözdizimi

SCCRTN SccAdd(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LPCSTR    lpComment,
   LONG*     pfOptions,
   LPCMDOPTS pvOptions
);

Parametreler

pvContext

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

Hwnd

[in] Kaynak denetimi eklentisinin sağladığı iletişim kutuları için üst öğe olarak kullanabileceği IDE penceresinin tanıtıcısı.

nFiles

[in] Dizide lpFileNames belirtildiği gibi geçerli projeye eklenecek seçilen dosya sayısı.

lpFileNames

[in] Eklenecek dosyaların tam yerel adları dizisi.

lpComment

[in] Eklenen tüm dosyalara uygulanacak açıklama.

pfOptions

[in] Dosya başına sağlanan komut bayrakları dizisi.

pvOptions

[in] Kaynak denetimi eklentisine özgü seçenekler.

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	Ekleme işlemi başarılı oldu.
SCC_E_FILEALREADYEXISTS	Seçili dosya zaten kaynak denetimi altında.
SCC_E_TYPENOTSUPPORTED	Dosyanın türü (örneğin, ikili) kaynak denetim sistemi tarafından desteklenmez.
SCC_E_OPNOTSUPPORTED	Kaynak denetim sistemi bu işlemi desteklemiyor.
SCC_E_ACCESSFAILURE	Büyük olasılıkla ağ veya çekişme sorunlarından dolayı kaynak denetim sistemine erişilirken bir sorun oluştu. Yeniden deneme önerilir.
SCC_E_NOTAUTHORIZED	Kullanıcının bu işlemi gerçekleştirmesine izin verilmiyor.
SCC_E_NONSPECIFICERROR	Özel olmayan hata; ekleme gerçekleştirilmedi.
SCC_I_OPERATIONCANCELED	İşlem tamamlanmadan iptal edildi.
SCC_I_RELOADFILE	Bir dosya veya projenin yeniden yüklenmesi gerekir.
SCC_E_FILENOTEXIST	Yerel dosya bulunamadı.

Açıklamalar

Burada her zamanki fOptions , dosya başına bir seçenek belirtimi ile bir dizi pfOptionsile LONG değiştirilir. Bunun nedeni dosya türünün dosyadan dosyaya farklılık göstermesidir.

Not

Aynı dosya için hem hem de SCC_FILETYPE_TEXT SCC_FILETYPE_BINARY seçenekleri belirtmek geçersizdir, ancak bunların hiçbirini belirtmek geçerli değildir. Ayarın hiçbiri ayarı SCC_FILETYPE_AUTOile aynı değildir; bu durumda kaynak denetimi eklentisi dosya türünü otomatik olarak algılar.

Dizide pfOptions kullanılan bayrakların listesi aşağıdadır:

Seçenek	Değer	Anlamı
SCC_FILETYPE_AUTO	0x00	Kaynak denetimi eklentisi dosya türünü algılamalıdır.
SCC_FILETYPE_TEXT	0x01	ASCII metin dosyasını gösterir.
SCC_FILETYPE_BINARY	0x02	ASCII metni dışında bir dosya türünü gösterir.
SCC_ADD_STORELATEST	0x04	Dosyanın yalnızca en son kopyasını depolar, değişiklik yoktur.
SCC_FILETYPE_TEXT_ANSI	0x08	Dosyaya ANSI metni olarak davranır.
SCC_FILETYPE_UTF8	0x10	Dosyayı UTF8 biçiminde Unicode metin olarak ele alır.
SCC_FILETYPE_UTF16LE	0x20	Dosyayı UTF16 Little Endian biçiminde Unicode metin olarak ele alır.
SCC_FILETYPE_UTF16BE	0x40	Dosyayı UTF16 Büyük Endian biçiminde Unicode metin olarak ele alır.

Ayrıca bkz.

• Kaynak denetimi eklentisi API işlevleri