SccQueryInfo 函式
這個函式會取得一組選取的檔案，請在 [原始檔控制下的狀態資訊。
SCCRTN SccQueryInfo(
LPVOID pvContext,
LONG nFiles,
LPCSTR* lpFileNames,
LPLONG lpStatus
);
參數
pvContext
[in]原始檔控制外掛程式的內容結構。nFiles
[in]控制台中的檔案數目lpFileNames的長度和陣列lpStatus陣列。lpFileNames
[in]要查詢的檔案名稱的陣列。lpStatus
輸入 [、 輸出]原始檔控制外掛程式用來傳回每個檔案的狀態旗標陣列。 如需詳細資訊，請參閱 檔案狀態碼列舉程式。
傳回值
原始檔控制外掛程式的實作這個函式被期待傳回下列值之一：
值 |
描述 |
|---|---|
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不是。