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 功能位時，才會呼叫此函式（如需此功能和其他功能位的詳細資訊，請參閱 功能旗 標）。

另請參閱