POPLISTFUNC
이 콜백은 IDE에서 SccPopulateList에 제공하고 소스 제어 플러그인에서 파일 또는 디렉터리 목록을 업데이트하는 데 사용합니다(SccPopulateList 함수에도 제공됨).
사용자가 IDE에서 가져오기 명령을 선택하면 IDE는 사용자가 가져올 수 있는 모든 파일의 목록 상자를 표시합니다. 아쉽게도 IDE는 사용자가 얻을 수 있는 모든 파일의 정확한 목록을 알지 못합니다. 플러그인에만 이 목록이 있습니다. 다른 사용자가 소스 코드 제어 프로젝트에 파일을 추가한 경우 이러한 파일이 목록에 나타나야 하지만 IDE는 해당 파일에 대해 알지 못합니다. IDE는 사용자가 가져올 수 있다고 판단하는 파일 목록을 작성합니다. 이 목록을 사용자에게 표시하기 전에 SccPopulateList,를 호출하여 소스 제어 플러그인에 목록에서 파일을 추가 및 삭제할 수 있는 기회를 제공합니다.
서명
소스 제어 플러그인은 다음과 같은 프로토타입으로 IDE 구현 함수를 호출하여 목록을 수정합니다.
typedef BOOL (*POPLISTFUNC) (
LPVOID pvCallerData,
BOOL fAddRemove,
LONG nStatus,
LPSTR lpFileName
);
매개 변수
pvCallerData 호출자(IDE)가 SccPopulateList에 전달한 The pvCallerData 매개 변수입니다. 소스 제어 플러그 인은 이 매개 변수의 내용에 대해 아무 것도 가정하지 않아야 합니다.
fAddRemove TRUE인 경우 lpFileName는 파일 목록에 추가해야 하는 파일입니다. FALSE인 경우 lpFileName은 파일 목록에 추가해야 하는 파일입니다.
lpFileName 상태(SCC_STATUS 비트 조합. 자세한 내용은 파일 상태 코드 참조)입니다.
lpFileName 목록에서 추가하거나 삭제할 파일 이름의 전체 디렉터리 경로입니다.
반환 값
| 값 | 설명 |
|---|---|
TRUE |
플러그 인은 이 함수를 계속 호출할 수 있습니다. |
FALSE |
IDE 쪽에 문제가 발생했습니다(예: 메모리 부족 상황). 플러그 인은 작업을 중지해야 합니다. |
설명
소스 제어 플러그인이 파일 목록에 추가하거나 파일 목록에서 삭제할 각 파일에 대해 lpFileName을 전달하여 이 함수를 호출합니다. fAddRemove 플래그는 목록에 추가할 새 파일 또는 삭제할 이전 파일을 나타냅니다. nStatus 매개 변수는 파일의 상태를 제공합니다. SCC 플러그인이 파일 추가 및 삭제를 완료하면 SccPopulateList 호출에서 반환됩니다.
참고 항목
Visual Studio에는 SCC_CAP_POPULATELIST 기능 비트가 필요합니다.