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 不是 。

另請參閱

• 原始檔控制外掛程式 API 函式
• 檔案狀態碼