SccAddFromScc 함수
이 함수는 소스 제어 시스템에 이미 있는 파일을 찾아볼 수 있습니다 고 이후에 현재 프로젝트에 해당 파일 포함을 확인. 예를 들어,이 함수는 파일을 복사 하지 않고 현재 프로젝트에 공용 헤더 파일을 얻을 수 있습니다. 파일의 반환 배열 lplpFileNames, 사용자가 IDE 프로젝트에 추가 하려는 파일의 목록을 포함 합니다.
SCCRTN SccAddFromScc (
LPVOID pvContext,
HWND hWnd,
LPLONG lpnFiles,
LPCSTR** lplpFileNames
);
매개 변수
pvContext
[in] 소스 제어 플러그 인 컨텍스트 구조체입니다.hWnd
[in] 소스 제어 플러그 인이 제공 하는 모든 대화 상자에 대 한 한 부모를 사용할 수 있는 IDE 창의 핸들입니다.lpnFiles
[in, out] 버퍼에 추가 된 파일의 수를. (이 NULL 가 메모리 가리키는 경우 lplpFileNames 출시 될 것입니다. 참고 자세한 내용은.)lplpFileNames
[in, out] 모든 파일 이름 없이 디렉터리 경로에 대 한 포인터의 배열입니다. 이 배열은 할당 하 고 해당 소스 제어 플러그 인을 해제입니다. 경우 lpnFiles = 1 및 lplpFileNames 수 없습니다 NULL, 수 배열에서 가리키는 의해 lplpFileNames 대상 폴더에 있습니다.
반환 값
이 함수의 소스 제어 플러그 인 구현 다음 값 중 하나가 반환 해야 합니다.
값 |
설명 |
|---|---|
SCC_OK |
파일에 있는 하 고 프로젝트에 추가 되었습니다 했습니다. |
SCC_I_OPERATIONCANCELED |
없음 효과 함께 작업을 취소 했습니다. |
SCC_I_RELOADFILE |
파일 또는 프로젝트를 다시 로드 해야 합니다. |
설명
IDE이이 함수를 호출합니다. 로컬 대상 폴더를 지정 하는 소스 제어 플러그 인을 지 원하는 경우 IDE를 통과 lpnFiles = 1 및 로컬 폴더 이름으로 전달 lplpFileNames.
때 호출 하는 SccAddFromScc 함수 반환, 플러그 인 지정 된 값으로 lpnFiles 및 lplpFileNames, 필요에 따라 파일 이름 배열에 대해 메모리를 할당 하 (이 할당 포인터를 대체 한 것 lplpFileNames). 소스 제어 플러그 인은 사용자 디렉터리 또는 지정 된 대상 폴더에 모든 파일 배치에 대 한 책임이 있습니다. IDE 다음 IDE 프로젝트에 파일을 추가합니다.
마지막으로, IDE이이 함수를 두 번의 호출 전달 NULL 에 대 한 lpnFiles. 이 파일 이름을 배열에 할당 된 메모리를 해제 하는 플러그 인은 소스 제어에서 특별 한 신호로 해석lplpFileNames.
lplpFileNames되는 char *** 포인터입니다. 소스 제어 플러그 인 목록이이 API에 대 한 표준 방식으로 전달 하 여 파일 이름에 대 한 포인터의 배열에 대 한 포인터를 놓습니다.
참고
초기 버전의 VSSCI API 대상 프로젝트에 추가 된 파일을 표시 하는 방법을 제공 하지 않습니다.이것의 의미를 수용 하는 lplpFIleNames 매개 변수는 출력 매개 변수 대신에 in/out 매개 변수를 확인 하려면 향상 되었습니다.단일 파일이 지정 된 경우에, 즉 값 가리키는 하 여 lpnFiles = 1, 첫 번째 요소를 lplpFileNames 대상 폴더에 있습니다.이러한 새로운 의미를 IDE 호출을 사용 하는 SccSetOption 기능을 nOption매개 변수를 설정 SCC_OPT_SHARESUBPROJ.플러그 인 의미를 지원 하지 않는 경우 반환 SCC_E_OPTNOTSUPPORTED.사용이 불가능 하 게 수행 하는 에서 소스 제어에 추가 기능.플러그인 지원 되는 경우는 추가 소스 제어에서 기능 (SCC_CAP_ADDFROMSCC), 새로운 기능을 지원 해야 하며 반환 하 고 SCC_I_SHARESUBPROJOK.