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 旗標。

另請參閱