Udostępnij za pośrednictwem


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.

Zobacz też