SccRename 函式
這個函式會在原始檔控制系統中，重新命名檔案。
SCCRTN SccRename(
LPVOID pvContext,
HWND hWnd,
LPCSTR lpFileName,
LPCSTR lpNewName
);
參數
pvContext
[in]原始檔控制外掛程式的內容結構。hWnd
[in]原始檔控制外掛程式可用於為父代對話框它所提供的 IDE 視窗控制代碼。lpFileName
[in]重新命名檔案的完整的檔案名稱。lpNewName
[in]完整格式的新名稱。 如果不同的目錄路徑，然後移動檔案從一個子目錄到另一個。
傳回值
原始檔控制外掛程式的實作這個函式被期待傳回下列值之一：
值 |
描述 |
|---|---|
SCC_OK |
重新命名作業已順利完成。 |
SCC_E_PROJNOTOPEN |
無法在原始檔控制開啟專案。 |
SCC_E_FILENOTCONTROLLED |
檔案不在原始檔控制中。 |
SCC_E_ACCESSFAILURE |
無法存取原始檔控制系統，可能因為到網路或爭用問題。 |
SCC_E_NOTAUTHORIZED |
使用者沒有完成這項作業的權限。 |
SCC_E_COULDNOTCREATEPROJECT |
無法重新命名的程序中建立專案。 |
SCC_E_OPNOTPERFORMED |
操作並未執行。 |
SCC_E_NONSPECIFICERROR |
發生未指定或一般錯誤。 |
備註
這個函式可用來重新命名檔案或將它從一個位置移到另一個原始檔控制系統中。 原始檔控制外掛程式不應嘗試存取磁碟上的檔案。 是要重新命名本機檔案的 IDE 的責任。