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]原始檔控制外掛程式專屬選項。
傳回值
原始檔控制外掛程式的實作這個函式被期待傳回下列值之一:
值 |
描述 |
---|---|
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 SourceSafe歷程記錄] 指令可讓使用者能夠取得較舊版本的檔案。 在這種情況下,原始檔控制外掛程式傳回SCC_I_RELOAD警告 IDE,而且必須重新載入檔案。
注意事項 |
---|
如果原始檔控制外掛程式不支援此函式用在陣列的檔案,就可以顯示只有第一個檔案的檔案記錄。 |