SccQueryInfo 函式
此函式會取得原始檔控制下一組所選檔案的狀態資訊。
語法
SCCRTN SccQueryInfo(
LPVOID pvContext,
LONG nFiles,
LPCSTR* lpFileNames,
LPLONG lpStatus
);
參數
pvContext
[in]原始檔控制外掛程式內容結構。
nFiles
[in]陣列中指定的 lpFileNames
檔案數目和數位的 lpStatus
長度。
lpFileNames
[in]要查詢之檔名的陣列。
lpStatus
[in, out]原始檔控制外掛程式會傳回每個檔案的狀態旗標的陣列。 如需詳細資訊,請參閱 檔案狀態代碼。
傳回值
此函式的原始檔控制外掛程式實作應該會傳回下列其中一個值:
值 | Description |
---|---|
SCC_OK | 查詢成功。 |
SCC_E_ACCESSFAILURE | 存取原始檔控制系統時發生問題,可能是網路或爭用問題所造成。 建議重試。 |
SCC_E_PROJNOTOPEN | 專案未在原始檔控制下開啟。 |
SCC_E_NONSPECIFICERROR | 非特定失敗。 |
備註
如果 lpFileName
是空字串,則目前沒有要更新的狀態資訊。 否則,它是狀態資訊可能已變更之檔案的完整路徑名稱。
傳回數位可以是位掩碼 SCC_STATUS_xxxx
。 如需詳細資訊,請參閱 檔案狀態代碼。 原始檔控制系統可能不支援所有位類型。 例如,如果未 SCC_STATUS_OUTOFDATE
提供 ,則位只是未設定。
使用此函式取出檔案時,請注意下列 MSSCCI
狀態需求:
SCC_STATUS_OUTBYUSER
會在目前使用者取出檔案時設定。SCC_STATUS_CHECKEDOUT
除非已設定,否則SCC_STATUS_OUTBYUSER
無法設定。SCC_STATUS_CHECKEDOUT
只有在檔案簽出到指定的工作目錄中時,才會設定 。如果目前使用者簽出檔案到工作目錄以外的目錄,
SCC_STATUS_OUTBYUSER
則會設定但SCC_STATUS_CHECKEDOUT
不是 。