共用方式為

SccDirQueryInfo 函式

  • 發行項

此函式會檢查其目前狀態的完整目錄清單。

語法

SCCRTN SccDirQueryInfo(
LPVOID  pContext,
LONG    nDirs,
LPCSTR* lpDirNames,
LPLONG  lpStatus
);

參數

pContext

[in]原始檔控制外掛程式內容結構。

nDirs

[in]要查詢的目錄數目。

lpDirNames

[in]要查詢之目錄的完整路徑陣列。

lpStatus

[in， out]原始檔控制外掛程式傳回狀態旗標的數位結構（如需詳細資訊，請參閱 目錄狀態代碼 ）。

傳回值

此函式的原始檔控制外掛程式實作應該會傳回下列其中一個值：

值 Description
SCC_OK 查詢成功。
SCC_E_OPNOTSUPPORTED 原始程式碼控制系統不支援這項作業。
SCC_E_ACCESSFAILURE 存取原始檔控制系統時發生問題，可能是因為網路或爭用問題。 建議重試。
SCC_E_NONSPECIFICERROR

SCC_E_UNKNOWNERROR		 非特定失敗。

備註

函式會以系列中的位掩碼 SCC_DIRSTATUS 填滿傳回數位列（請參閱 目錄狀態代碼），每個指定的目錄各輸入一個專案。 狀態陣列是由呼叫端所配置。

IDE 會在重新命名目錄之前使用此函式，藉由查詢目錄是否有對應的專案，以檢查目錄是否處於原始檔控制之下。 如果目錄不在原始檔控制之下，IDE 可以提供適當的警告給使用者。

注意

如果原始檔控制外掛程式選擇不實作一或多個狀態值，則未實作的位應該設定為零。

另請參閱