SccHistory 函式

  • 發行項

此函式會顯示指定檔案的歷程記錄。

語法

SCCRTN SccHistory(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LONG      fOptions,
   LPCMDOPTS pvOptions
);

參數

pvContext

[in]原始檔控制外掛程式內容結構。

hWnd

[in]原始檔控制外掛程式可作為其提供之任何對話框之父代的 IDE 視窗句柄。

nFiles

[in]陣列中指定的 lpFileName 檔案數目。

lpFileName

[in]檔案完整名稱的陣列。

fOptions

[in]命令旗標（目前未使用）。

pvOptions

[in]原始檔控制外掛程式特定選項。

傳回值

此函式的原始檔控制外掛程式實作應該會傳回下列其中一個值：

值 Description
SCC_OK 已成功取得版本歷程記錄。
SCC_I_RELOADFILE 原始檔控制系統實際上在擷取歷程記錄時修改了磁碟上的檔案（例如，藉由取得舊版的檔案），因此 IDE 應該重載此檔案。
SCC_E_FILENOTCONTROLLED 檔案不在原始檔控制之下。
SCC_E_OPNOTSUPPORTED 原始檔控制系統不支援這項作業。
SCC_E_NOTAUTHORIZED 不允許使用者執行這項作業。
SCC_E_ACCESSFAILURE 存取原始檔控制系統時發生問題，可能是因為網路或爭用問題。 建議重試。
SCC_E_PROJNOTOPEN 專案尚未開啟。
SCC_E_NONSPECIFICERROR 非特定失敗。 無法取得檔案歷程記錄。

備註

原始檔控制外掛程式可以顯示自己的對話方塊，以使用 hWnd 作為父視窗來顯示每個檔案的歷程記錄。 或者，如果支援，可以使用提供給 SccOpenProject 的選擇性文字輸出回呼函式。

請注意，在某些情況下，正在檢查的檔案可能會在執行此呼叫期間變更。 例如，Visual Source 保管庫 history 命令可讓用戶有機會取得舊版的檔案。 在這種情況下，原始檔控制外掛程式會傳回 SCC_I_RELOAD ，以警告 IDE 需要重載檔案。

注意

如果原始檔控制外掛程式不支援檔案數位的這個函式，則只能顯示第一個檔案的檔案歷程記錄。

另請參閱