SccUncheckout 函式
此函式會復原先前的簽出作業,藉此將選取的檔案或檔案的內容還原到簽出前的狀態。 簽出后對檔案所做的所有變更都會遺失。
語法
SCCRTN SccUncheckout (
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* lpFileNames,
LONG fOptions,
LPCMDOPTS pvOptions
);
參數
pvContext
[in]原始檔控制外掛程式內容結構。
hWnd
[in]原始檔控制外掛程式可作為其提供之任何對話框之父代的 IDE 視窗句柄。
nFiles
[in]陣列中指定的 lpFileNames
檔案數目。
lpFileNames
[in]要復原簽出之檔案的完整本機路徑名稱陣列。
fOptions
[in]命令旗標(未使用)。
pvOptions
[in]原始檔控制外掛程式特定選項。
傳回值
此函式的原始檔控制外掛程式實作應該會傳回下列其中一個值:
值 | Description |
---|---|
SCC_OK | 復原簽出成功。 |
SCC_E_FILENOTCONTROLLED | 選取的檔案不在原始程式碼控制之下。 |
SCC_E_ACCESSFAILURE | 存取原始檔控制系統時發生問題,可能是因為網路或爭用問題。 建議重試。 |
SCC_E_NONSPECIFICERROR | 非特定失敗。 復原簽出未成功。 |
SCC_E_NOTCHECKEDOUT | 用戶沒有取出檔案。 |
SCC_E_NOTAUTHORIZED | 不允許使用者執行這項作業。 |
SCC_E_PROJNOTOPEN | 專案尚未從原始檔控制開啟。 |
SCC_I_OPERATIONCANCELED | 作業在完成之前已取消。 |
備註
此作業之後, SCC_STATUS_CHECKEDOUT
將會針對執行復原簽出的檔案清除 和 SCC_STATUS_MODIFIED
旗標。