錯誤碼
當原始檔控制外掛程式的 API 函式會傳回錯誤時，它必須是下列的錯誤代碼的其中一個。 所有的錯誤是負值，警告或資訊的錯誤代碼是正數，而成功為 0。
錯誤碼 |
值 |
描述 |
|---|---|---|
SCC_I_SHARESUBPROJOK |
7 |
新增檔案，從兩個步驟中的原始檔控制外掛程式的支援。 如需詳細資訊，請參閱 SccSetOption 函式。 |
SCC_I_FILEDIFFERS |
6 |
本機檔案是不同於原始檔控制資料庫中的檔案 (例如， SccDiff 函式可能會傳回此值)。 |
SCC_I_RELOADFILE |
5 |
本機檔案已經在原始檔控制作業中 ； IDE 應該盡可能重新載入檔案。 |
SCC_I_FILENOTAFFECTED |
4 |
檔案不會受到影響。 |
SCC_I_PROJECTCREATED |
3 |
原始檔控制作業時所建立的專案 (例如，在呼叫SccOpenProject 函式時SCC_OP_CREATEIFNEW指定旗標)。 |
SCC_I_OPERATIONCANCELED |
2 |
作業已取消。 |
SCC_I_ADV_SUPPORT |
1 |
指定的命令的進階選項外掛程式的支援。 如需詳細資訊，請參閱 SccGetCommandOptions 函式。 |
SCC_OK |
0 |
成功。 |
SCC_E_INITIALIZEFAILED |
-1 |
錯誤: 初始化失敗。 |
SCC_E_UNKNOWNPROJECT |
-2 |
錯誤: 專案是未知的。 |
SCC_E_COULDNOTCREATEPROJECT |
-3 |
錯誤: 無法建立專案。 |
SCC_E_NOTCHECKEDOUT |
-4 |
錯誤: 檔案未簽出。 |
SCC_E_ALREADYCHECKEDOUT |
-5 |
錯誤: 檔案已經簽出。 |
SCC_E_FILEISLOCKED |
-6 |
錯誤: 檔案已被鎖定。 |
SCC_E_FILEOUTEXCLUSIVE |
-7 |
錯誤: 檔案以獨佔方式簽出。 |
SCC_E_ACCESSFAILURE |
-8 |
無法存取原始檔控制系統，可能因為到網路或爭用問題。 建議您重試。 |
SCC_E_CHECKINCONFLICT |
-9 |
錯誤: 發生衝突時簽入。 |
SCC_E_FILEALREADYEXISTS |
-10 |
錯誤: 檔案已經存在。 |
SCC_E_FILENOTCONTROLLED |
-11 |
錯誤: 檔案不是原始檔控制之下。 |
SCC_E_FILEISCHECKEDOUT |
-12 |
錯誤: 已簽出檔案。 |
SCC_E_NOSPECIFIEDVERSION |
-13 |
錯誤: 沒有任何指定的版本。 |
SCC_E_OPNOTSUPPORTED |
-14 |
錯誤: 不支援的操作。 |
SCC_E_NONSPECIFICERROR |
-15 |
不明確的錯誤。 |
SCC_E_OPNOTPERFORMED |
-16 |
錯誤，這項操作無法執行。 |
SCC_E_TYPENOTSUPPORTED |
-17 |
錯誤: 原始檔控制系統不支援的檔案類型，例如，二進位。 |
SCC_E_VERIFYMERGE |
-18 |
檔案已被自動合併，但因為它是擱置中的使用者驗證尚未簽。 |
SCC_E_FIXMERGE |
-19 |
檔案已被自動合併，但有尚未簽入受限於必須以手動方式解決合併衝突。 |
SCC_E_SHELLFAILURE |
-20 |
因為 shell 失敗錯誤。 |
SCC_E_INVALIDUSER |
-21 |
錯誤: 使用者不正確。 |
SCC_E_PROJECTALREADYOPEN |
-22 |
錯誤: 專案已經開啟。 |
SCC_E_PROJSYNTAXERR |
-23 |
專案的語法錯誤。 |
SCC_E_INVALIDFILEPATH |
-24 |
錯誤: 檔案路徑不正確。 |
SCC_E_PROJNOTOPEN |
-25 |
錯誤: 專案未開啟。 |
SCC_E_NOTAUTHORIZED |
-26 |
錯誤: 使用者沒有權限才能執行此作業。 |
SCC_E_FILESYNTAXERR |
-27 |
檔案有語法錯誤。 |
SCC_E_FILENOTEXIST |
-28 |
錯誤，本機檔案不存在。 |
SCC_E_CONNECTIONFAILURE |
-29 |
錯誤: 發生連線失敗。 |
SCC_E_UNKNOWNERROR |
-30 |
未知的錯誤。 |
SCC_E_BACKGROUNDGETINPROGRESS |
-31 |
背景 get 作業正在進行中。 |
快速檢查所提供的巨集
IS_SCC_ERROR(rtn) (((rtn) < 0) ? TRUE : FALSE)
IS_SCC_SUCCESS(rtn) (((rtn) == SCC_OK) ? TRUE : FALSE)
IS_SCC_WARNING(rtn) (((rtn) > 0) ? TRUE : FALSE)
備註
所有的原始檔控制外掛程式的 API 函式 (除了SccAdd 函式， SccCheckin 函式，以及SccDiff 函式) 都必須成功時傳遞為引數的本機檔案不存在於工作資料夾。 例如，IDE 可能發出的呼叫SccCheckout 函式或SccUncheckout 函式不存在於 [工作] 資料夾中，但存在於原始檔控制系統中的檔案上。 這個呼叫會成功。 在 [工作] 資料夾，或在原始檔控制系統中沒有檔案時，才是函式預期會失敗。
某些功能，例如SccAdd和SccCheckin，應該明確傳回SCC_E_FILENOTEXIST的工作資料夾中的檔案並不存在。 其他函式都必須完成的工作檔案不存在，如果函式作業上有效的檔名，在 [原始檔控制系統。
原始檔控制外掛程式在即使外掛程式已標示檔案唯讀某些作業期間，應該在 [工作] 資料夾中，作任何假設，關於檔案的權限。 可以移動、 刪除及隨單元的控制項外變更了工作資料夾中的檔案。