SccRename, funkcja
Ta funkcja zmienia nazwę pliku w systemie kontroli źródła.
Składnia
SCCRTN SccRename(
LPVOID pvContext,
HWND hWnd,
LPCSTR lpFileName,
LPCSTR lpNewName
);
Parametry
pvContext
[in] Struktura kontekstu wtyczki kontroli źródła.
Hwnd
[in] Dojście do okna środowiska IDE, którego wtyczka kontroli źródła może używać jako elementu nadrzędnego dla wszystkich okien dialogowych, które udostępnia.
lpFileName
[in] W pełni kwalifikowana nazwa pliku, który jest zmieniany.
lpNewName
[in] W pełni kwalifikowana nowa nazwa. Jeśli ścieżka katalogu jest inna, plik został przeniesiony z jednego podkatalogu do innego.
Wartość zwracana
Implementacja wtyczki kontroli źródła tej funkcji powinna zwrócić jedną z następujących wartości:
| Wartość | Opis |
|---|---|
| SCC_OK | Operacja zmiany nazwy została ukończona pomyślnie. |
| SCC_E_PROJNOTOPEN | Projekt nie jest otwarty pod kontrolą źródła. |
| SCC_E_FILENOTCONTROLLED | Plik nie jest pod kontrolą źródła. |
| SCC_E_ACCESSFAILURE | Wystąpił problem podczas uzyskiwania dostępu do systemu kontroli źródła, prawdopodobnie z powodu problemów z siecią lub rywalizacją. |
| SCC_E_NOTAUTHORIZED | Użytkownik nie ma autoryzacji do ukończenia tej operacji. |
| SCC_E_COULDNOTCREATEPROJECT | Nie można utworzyć projektu w ramach procesu zmiany nazwy. |
| SCC_E_OPNOTPERFORMED | Operacja nie została wykonana. |
| SCC_E_NONSPECIFICERROR | Wystąpił nieokreślony lub ogólny błąd. |
Uwagi
Tej funkcji można użyć do zmiany nazwy pliku lub przeniesienia go z jednej lokalizacji do innej w systemie kontroli źródła. Wtyczka kontroli źródła nie powinna podejmować próby uzyskania dostępu do pliku na dysku. Jest to odpowiedzialność ide za zmianę nazwy pliku lokalnego.