SccAdd 函式
這個函式會將新的檔案加入至原始檔控制系統。
SCCRTN SccAdd(
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* lpFileNames,
LPCSTR lpComment,
LONG* pfOptions,
LPCMDOPTS pvOptions
);
參數
pvContext
[in]原始檔控制外掛程式的內容結構。hWnd
[in]原始檔控制外掛程式可用於為父代對話框它所提供的 IDE 視窗控制代碼。nFiles
[in]選取要加入至目前的專案中指定的檔案數量lpFileNames陣列。lpFileNames
[in]要加入的檔案的完整本機名稱陣列。lpComment
[in]要套用到所有的檔案新增註解。pfOptions
[in]命令旗標，以每個檔案為基礎所提供的陣列。pvOptions
[in]原始檔控制外掛程式專屬選項。
傳回值
原始檔控制外掛程式的實作這個函式被期待傳回下列值之一：
值 |
描述 |
|---|---|
SCC_OK |
新增作業已成功。 |
SCC_E_FILEALREADYEXISTS |
選取的檔案已經是原始檔控制之下。 |
SCC_E_TYPENOTSUPPORTED |
原始檔控制系統不支援 (例如二進位) 檔的類型。 |
SCC_E_OPNOTSUPPORTED |
原始檔控制系統不支援這項作業。 |
SCC_E_ACCESSFAILURE |
無法存取原始檔控制系統，可能因為到網路或爭用問題。 建議您重試。 |
SCC_E_NOTAUTHORIZED |
若要執行這項作業不允許使用者。 |
SCC_E_NONSPECIFICERROR |
非特定的失敗。 將不會執行。 |
SCC_I_OPERATIONCANCELED |
在完成之前取消作業。 |
SCC_I_RELOADFILE |
需要重新載入檔案或專案。 |
SCC_E_FILENOTEXIST |
找不到本機檔案。 |
備註
一般fOptions會取代此陣列中， pfOptions，其中一種LONG選項規格，每個檔案。 這是因為檔案類型可能會不同檔案。
.gif "注意事項") 注意事項 |
|---|
是無效的同時指定兩者的SCC_FILETYPE_TEXT和SCC_FILETYPE_BINARY選項相同的檔案，但卻是指定不正確。設定都不等同於設定SCC_FILETYPE_AUTO，在此情況下的原始檔控制外掛程式的 autodetects 的檔案類型。 |
下面是清單中所使用的旗標pfOptions陣列：
選項 |
值 |
意義 |
|---|---|---|
SCC_FILETYPE_AUTO |
0x00 |
原始檔控制外掛程式應該會偵測到的檔案類型。 |
SCC_FILETYPE_TEXT |
0x01 |
表示一個 ASCII 文字檔。 |
SCC_FILETYPE_BINARY |
0x02 |
指出 ASCII 文字以外的檔案類型。 |
SCC_ADD_STORELATEST |
0x04 |
儲存檔案，也就是沒有差異的最新複本。 |
SCC_FILETYPE_TEXT_ANSI |
0x08 |
視為 ANSI 文字中的檔案。 |
SCC_FILETYPE_UTF8 |
0x10 |
為 UTF8 格式的 Unicode 文字，會將該檔案。 |
SCC_FILETYPE_UTF16LE |
0x20 |
將檔案視為 UTF16 Unicode 文字一點位元組由小到大的格式。 |
SCC_FILETYPE_UTF16BE |
0x40 |
歸檔為] 中 UTF16 大位元組 Unicode 文字格式設定身分。 |