SccCheckout 函式
指定完整檔名的清單,此函式會將它們簽出至本機磁碟驅動器。 批注適用於正在取出的所有檔案。批註自變數可以是 null
字串。
語法
SCCRTN SccCheckout (
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* lpFileNames,
LPCSTR lpComment,
LONG fOptions,
LPCMDOPTS pvOptions
);
參數
pvContext
[in]原始檔控制外掛程式內容結構。
hWnd
[in]原始檔控制外掛程式可作為其提供之任何對話框之父代的 IDE 視窗句柄。
nFiles
[in]選取要取出的檔案數目。
lpFileNames
[in]要取出之檔案的完整本機路徑名稱陣列。
lpComment
[in]要套用至要取出之每個選取檔案的批注。
fOptions
[in]命令旗標(請參閱 特定命令所使用的 Bitflags)。
pvOptions
[in]原始檔控制外掛程式特定選項。
傳回值
此函式的原始檔控制外掛程式實作應該會傳回下列其中一個值:
值 | Description |
---|---|
SCC_OK | 簽出成功。 |
SCC_E_FILENOTCONTROLLED | 選取的檔案不在原始程式碼控制之下。 |
SCC_E_ACCESSFAILURE | 存取原始檔控制系統時發生問題,可能是因為網路或爭用問題。 建議重試。 |
SCC_E_NOTAUTHORIZED | 不允許使用者執行這項作業。 |
SCC_E_NONSPECIFICERROR | 非特定失敗。 檔案未取出。 |
SCC_E_ALREADYCHECKEDOUT | 用戶已經取出檔案。 |
SCC_E_FILEISLOCKED | 檔案已鎖定,禁止建立新版本。 |
SCC_E_FILEOUTEXCLUSIVE | 另一位使用者已完成此檔案的獨佔簽出。 |
SCC_I_OPERATIONCANCELED | 作業在完成之前已取消。 |