Share via

SccRename Function

  • Article

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

This function renames a file in the source control system.

Syntax

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

Parameters

pvContext

[in] The source control plug-in context structure.

hWnd

[in] A handle to the IDE window that the source control plug-in can use as a parent for any dialog boxes that it provides.

lpFileName

[in] The fully qualified file name of the file being renamed.

lpNewName

[in] The fully qualified new name. If the directory path is different, then the file has moved from one subdirectory to another.

Return Value

The source control plug-in implementation of this function is expected to return one of the following values:

Value Description
SCC_OK The renaming operation completed successfully.
SCC_E_PROJNOTOPEN The project is not open under source control.
SCC_E_FILENOTCONTROLLED The file is not under source control.
SCC_E_ACCESSFAILURE There was a problem accessing the source control system, probably due to network or contention issues.
SCC_E_NOTAUTHORIZED The user is not authorized to complete this operation.
SCC_E_COULDNOTCREATEPROJECT The project could not be created as part of the renaming process.
SCC_E_OPNOTPERFORMED The operation was not performed.
SCC_E_NONSPECIFICERROR An unspecified or general error occurred.

Remarks

This function can be used to rename a file or move it from one location to another in the source control system. The source control plug-in should not attempt to access the file on disk. It is the IDE's responsibility to rename the local file.

See also