特定命令所使用的位旗標
原始檔控制外掛程式 API 中許多函式的行為可藉由在單一值中設定一或多個位來修改。 這些值稱為 bitflags。 原始檔控制外掛程式 API 所使用的各種位旗標會在這裡詳述，並依使用它們的函式分組。
取出旗標
您可以為 SccAdd 或 SccCheckin 設定此旗標。
| 旗標 | 值 | Description |
|---|---|---|
SCC_KEEP_CHECKEDOUT |
0x1000 | 讓檔案保持取出狀態。 |
新增旗標
SccAdd 會使用這些旗標。
| 旗標 | 值 | Description |
|---|---|---|
SCC_FILETYPE_AUTO |
0x00 | 原始檔控制外掛程式應該會自動偵測檔案是文字還是二進位檔。 |
SCC_FILETYPE_TEXT |
0x01 | 檔類型為文字。 |
SCC_FILETYPE_BINARY |
0x04 | 檔類型為二進位檔。 注意： SCC_FILETYPE_TEXT 和 SCC_FILETYPE_BINARY 旗標互斥。 只設定一個或兩者皆未設定。 |
SCC_ADD_STORELATEST |
0x02 | 僅儲存最新版本（無差異）。 |
差異旗標
SccDiff 會使用這些旗標來定義差異作業的範圍。 旗 SCC_DIFF_QD_xxx 標互斥。 如果其中任一項已指定，則不會提供任何視覺意見反應。 在「快速差異」（QD）中，外掛程式不會判斷檔案的不同方式，只有在檔案不同時。 如果未指定這些旗標，則會完成「視覺差異」;詳細的檔案差異會計算並顯示。 如果不支援要求的 QD，外掛程式會移至下一個最佳 QD。 例如，如果 IDE 要求總和檢查碼，而外掛程式不支援檢查碼，則外掛程式會執行完整內容檢查（仍然比視覺顯示快得多）。
| 旗標 | 值 | Description |
|---|---|---|
SCC_DIFF_IGNORECASE |
0x0002 | 忽略大小寫差異。 |
SCC_DIFF_IGNORESPACE |
0x0004 | 忽略空格符差異。 注意：SCC_DIFF_IGNORECASE和 SCC_DIFF_IGNORESPACE 旗標是選擇性的位旗標。 |
SCC_DIFF_QD_CONTENTS |
0x0010 | 比較整個檔案內容的 QD。 |
SCC_DIFF_QD_CHECKSUM |
0x0020 | 總和檢查碼的 QD。 |
SCC_DIFF_QD_TIME |
0x0040 | 依檔案日期/時間戳的 QD。 |
SCC_DIFF_QUICK_DIFF |
0x0070 | 這是用來檢查所有 QD 位旗標的遮罩。 它不應該傳遞至函式;這三個 QD 位旗標互斥。 QD 一律表示不會顯示UI。 |
PopulateList 旗標
參數中的 fOptions SccPopulateList 會使用此旗標。
| 旗標 | 值 | Description |
|---|---|---|
SCC_PL_DIR |
0x00000001L | IDE 正在傳遞目錄，而不是檔案。 |
PopulateDirList 旗標
參數中的 fOptions SccPopulateDirList 會使用這些旗標。
| 選項值 | 值 | Description |
|---|---|---|
| SCC_PDL_ONELEVEL | 0x0000 | 只檢查目錄的一個層級（這是預設值）。 |
| SCC_PDL_RECURSIVE | 0x0001 | 以遞歸方式檢查每個指定目錄下的所有目錄。 |
| SCC_PDL_INCLUDEFILES | 0x0002 | 在檢查程式中包含檔名。 |
OpenProject 旗標
參數中的 dwFlags SccOpenProject 會使用這些旗標。
| 選項值 | 值 | Description |
|---|---|---|
| SCC_OP_CREATEIFNEW | 0x00000001L | 如果專案不存在於原始檔控制中，請加以建立。 如果未設定此旗標，請提示使用者建立專案（除非 SCC_OP_SILENTOPEN 指定旗標）。 |
| SCC_OP_SILENTOPEN | 0x00000002L | 請勿提示使用者建立專案;只要傳回 SCC_E_UNKNOWNPROJECT。 |
取得旗標
SccGet 和 SccCheckout 會使用這些旗標。
| 旗標 | 值 | Description |
|---|---|---|
SCC_GET_ALL |
0x00000001L | IDE 正在傳遞目錄，而不是檔案：取得這些目錄中的所有檔案。 |
SCC_GET_RECURSIVE |
0x00000002L | IDE 正在傳遞目錄：取得這些目錄及其所有子目錄。 |
nOption 值
參數中的 nOption SccSetOption 會使用這些旗標。
| 旗標 | 值 | Description |
|---|---|---|
SCC_OPT_EVENTQUEUE |
0x00000001L | 設定事件佇列的狀態。 |
SCC_OPT_USERDATA |
0x00000002L | 指定的用戶數據 SCC_OPT_NAMECHANGEPFN。 |
SCC_OPT_HASCANCELMODE |
0x00000003L | IDE 可以處理取消。 |
SCC_OPT_NAMECHANGEPFN |
0x00000004L | 設定名稱變更的回呼。 |
SCC_OPT_SCCCHECKOUTONLY |
0x000000005L | 停用原始檔控制外掛程式 UI 簽出，且未設定工作目錄。 |
SCC_OPT_SHARESUBPROJ |
0x00000006L | 從原始檔控制系統新增以指定工作目錄。 如果是直接子系，請嘗試共用至相關聯的專案。 |
dwVal bitflags
參數中的 dwVal SccSetOption 會使用這些旗標。
| 旗標 | 值 | Description | 依 nOption 值使用 |
|---|---|---|---|
SCC_OPT_EQ_DISABLE |
0x00L | 暫停事件佇列活動。 | SCC_OPT_EVENTQUEUE |
SCC_OPT_EQ_ENABLE |
0x01L | 啟用事件佇列記錄。 | SCC_OPT_EVENTQUEUE |
SCC_OPT_HCM_NO |
0L | （預設值）沒有取消模式;外掛程式必須視需要提供。 | SCC_OPT_HASCANCELMODE |
SCC_OPT_HCM_YES |
1L | IDE 會處理取消。 | SCC_OPT_HASCANCELMODE |
SCC_OPT_SCO_NO |
0L | （預設值）確定可從外掛程式 UI 取出;工作目錄已設定。 | SCC_OPT_SCCCHECKOUTONLY |
SCC_OPT_SCO_YES |
1L | 沒有外掛程式 UI 簽出，沒有工作目錄。 | SCC_OPT_SCCCHECKOUTONLY |