SccRename İşlevi

Bu işlev, kaynak denetim sistemindeki bir dosyayı yeniden adlandırır.

Sözdizimi

SCCRTN SccRename(
   LPVOID pvContext,
   HWND   hWnd,
   LPCSTR lpFileName,
   LPCSTR lpNewName
);

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ı.

lpFileName

[in] Yeniden adlandırılan dosyanın tam dosya adı.

lpNewName

[in] Tam yeni ad. Dizin yolu farklıysa, dosya bir alt dizinden diğerine taşınmıştı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	Yeniden adlandırma işlemi başarıyla tamamlandı.
SCC_E_PROJNOTOPEN	Proje kaynak denetimi altında açık değil.
SCC_E_FILENOTCONTROLLED	Dosya kaynak denetimi altında değil.
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.
SCC_E_NOTAUTHORIZED	Kullanıcının bu işlemi tamamlama yetkisi yok.
SCC_E_COULDNOTCREATEPROJECT	Proje yeniden adlandırma işleminin bir parçası olarak oluşturulamadı.
SCC_E_OPNOTPERFORMED	İşlem gerçekleştirilmedi.
SCC_E_NONSPECIFICERROR	Belirtilmeyen veya genel bir hata oluştu.

Açıklamalar

Bu işlev, bir dosyayı yeniden adlandırmak veya kaynak denetim sisteminde bir konumdan diğerine taşımak için kullanılabilir. Kaynak denetimi eklentisi diskteki dosyaya erişmeye çalışmamalıdır. Yerel dosyayı yeniden adlandırmak IDE'nin sorumluluğundadır.

Ayrıca bkz.

• Kaynak Denetimi Eklentisi API İşlevleri