SccRunScc 函式
此函式會叫用原始檔控制管理工具。
語法
SCCRTN SccRunScc(
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* lpFileNames
);
參數
pvContext
[in]原始檔控制外掛程式內容結構。
hWnd
[in]原始檔控制外掛程式可作為其提供之任何對話框之父代的 IDE 視窗句柄。
nFiles
[in]陣列中指定的 lpFileNames
檔案數目。
lpFileNames
[in]選取檔案名的陣列。
傳回值
此函式的原始檔控制外掛程式實作應該會傳回下列其中一個值:
值 | Description |
---|---|
SCC_OK | 已成功叫用原始檔控制管理工具。 |
SCC_I_OPERATIONCANCELED | 作業已取消。 |
SCC_E_INITIALIZEFAILED | 無法初始化原始檔控制系統。 |
SCC_E_ACCESSFAILURE | 存取原始檔控制系統時發生問題,可能是因為網路或爭用問題。 |
SCC_E_CONNECTIONFAILURE | 無法連線到原始檔控制系統。 |
SCC_E_FILENOTCONTROLLED | 選取的檔案不在原始檔控制之下。 |
SCC_E_NONSPECIFICERROR | 非特定失敗。 |
備註
此函式可讓呼叫端透過外部管理工具存取原始檔控制系統的完整功能。 如果原始檔控制系統沒有使用者介面,原始檔控制外掛程式可以實作介面來執行必要的管理功能。
此函式是以目前選取檔案的計數和檔名陣列來呼叫。 如果管理工具支援,則可以使用檔案清單在系統管理介面中預先選取檔案;否則,可以忽略清單。
當使用者從 [檔案>- 原始檔控制] 功能選取 [啟動<原始檔控制伺服器>] 時,通常會叫用此函式。 設定登錄專案,可以一律停用或隱藏此 [啟動 ] 功能表選項。 如需詳細資訊,請參閱 如何:安裝原始檔控制外掛程式 。 只有當 SccInitialize 傳回 SCC_CAP_RUNSCC
功能位時,才會呼叫此函式(如需此功能和其他功能位的詳細資訊,請參閱 功能旗 標)。