SccRename 函式

此函式會重新命名原始檔控制系統中的檔案。

語法

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

參數

pvContext

[in]原始檔控制外掛程式內容結構。

hWnd

[in]原始檔控制外掛程式可作為其提供之任何對話框之父代的 IDE 視窗句柄。

lpFileName

[in]要重新命名之檔案的完整檔名。

lpNewName

[in]完整新名稱。 如果目錄路徑不同，則檔案已從某個子目錄移至另一個子目錄。

傳回值

此函式的原始檔控制外掛程式實作應該會傳回下列其中一個值：

值	Description
SCC_OK	重新命名作業已順利完成。
SCC_E_PROJNOTOPEN	專案未在原始檔控制下開啟。
SCC_E_FILENOTCONTROLLED	檔案不在原始檔控制之下。
SCC_E_ACCESSFAILURE	存取原始檔控制系統時發生問題，可能是因為網路或爭用問題。
SCC_E_NOTAUTHORIZED	用戶無權完成這項作業。
SCC_E_COULDNOTCREATEPROJECT	無法建立專案做為重新命名程式的一部分。
SCC_E_OPNOTPERFORMED	未執行作業。
SCC_E_NONSPECIFICERROR	發生未指定的或一般錯誤。

備註

此函式可用來重新命名檔案，或將檔案從原始檔控制系統中的某個位置移至另一個位置。 原始檔控制外掛程式不應該嘗試存取磁碟上的檔案。 IDE 有責任重新命名本機檔案。

另請參閱

• 原始檔控制外掛程式 API 函式