POPLISTFUNC

發行項
05/16/2015

這個回呼提供給SccPopulateList 函式 ide，由原始檔控制外掛程式用來更新一份檔案或目錄 (也提供給SccPopulateList函式)。

當使用者選擇取得命令在 IDE 中，IDE 會顯示使用者可以取得的所有檔案的清單方塊。不幸的是，IDE 不知道明確的使用者可能會接到；所有檔案清單只有外掛程式擁有這份清單。如果其他使用者將檔案新增至原始檔控制專案中，這些檔案應該會出現在清單中，但是 IDE 不知道他們。 IDE 會建立一份認為某個使用者可以取得的檔案。它會對使用者顯示這份清單之前，它會呼叫SccPopulateList 函式,提供原始檔控制外掛程式加入，並從清單中刪除檔案。

Signature

原始檔控制外掛程式會修改清單，藉由呼叫 IDE 實作函式具有下列原型：

typedef BOOL (*POPLISTFUNC) (
   LPVOID pvCallerData,
   BOOL fAddRemove,
   LONG nStatus,
   LPSTR lpFileName
);

參數

pvCallerData
pvCallerData參數傳遞至呼叫端 (IDE) SccPopulateList 函式。原始檔控制外掛程式應該假設不瞭解這個參數的內容。
fAddRemove
如果TRUE， lpFileName是一個檔案，應該加入至檔案清單。如果FALSE， lpFileName是應該從 [檔案] 清單中刪除的檔案。
nStatus
狀態的lpFileName (結合SCC_STATUS位元。請參閱檔案狀態碼列舉程式如需詳細資訊)。
lpFileName
若要新增或刪除清單中的檔案名稱的完整目錄路徑。

傳回值

值	描述
TRUE	外掛程式可以繼續呼叫這個函式。
FALSE	在 IDE 端 (例如不足的記憶體的狀況) 已有問題。此外掛程式應該停止作業。

備註

針對每個想要新增或刪除的檔案清單的原始檔控制外掛程式的檔案，它會呼叫這個函式，傳遞lpFileName。 fAddRemove旗標會指出要新增至清單的檔案或刪除舊的檔案。 nStatus參數會指定檔案的狀態。當外掛程式 SCC 完成加入和刪除檔案時，它會傳回SccPopulateList 函式呼叫。