SccAdd 함수

이 함수는 소스 제어 시스템에 새 파일을 추가합니다.

구문

SCCRTN SccAdd(
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   LPCSTR    lpComment,
   LONG*     pfOptions,
   LPCMDOPTS pvOptions
);

매개 변수

pvContext

[in] 소스 제어 플러그 인 컨텍스트 구조입니다.

hWnd

[in] 소스 제어 플러그 인이 제공하는 대화 상자의 부모로 사용할 수 있는 IDE 창에 대한 핸들입니다.

nFiles

[in] lpFileNames 배열에 지정된 대로 현재 프로젝트에 추가하도록 선택한 파일 수입니다.

lpFileNames

[in] 추가할 파일의 정규화된 로컬 이름의 배열입니다.

lpComment

[in] 추가되는 모든 파일에 적용할 주석입니다.

pfOptions

[in] 파일 단위로 제공되는 명령 플래그의 배열입니다.

pvOptions

[in] 소스 제어 플러그 인 관련 옵션입니다.

반환 값

이 함수의 소스 제어 플러그 인 구현은 다음 값 중 하나를 반환해야 합니다.

값	Description
SCC_OK	추가 작업이 완료되었습니다.
SCC_E_FILEALREADYEXISTS	선택한 파일이 이미 소스 제어를 받고 있습니다.
SCC_E_TYPENOTSUPPORTED	파일 형식(예: 이진)이 소스 제어 시스템에서 지원되지 않습니다.
SCC_E_OPNOTSUPPORTED	원본 제어 시스템이 이 작업을 지원하지 않습니다.
SCC_E_ACCESSFAILURE	네트워크 또는 경합 문제로 인해 소스 제어 시스템에 액세스하는 데 문제가 발생했습니다. 다시 시도하는 것이 좋습니다.
SCC_E_NOTAUTHORIZED	사용자는 이 작업을 수행할 수 없습니다.
SCC_E_NONSPECIFICERROR	비특이적 오류. 추가가 수행되지 않았습니다.
SCC_I_OPERATIONCANCELED	작업이 완료되기 전에 취소되었습니다.
SCC_I_RELOADFILE	파일 또는 프로젝트를 다시 로드해야 합니다.
SCC_E_FILENOTEXIST	로컬 파일을 찾을 수 없습니다.

설명

일반적인 fOptions는 여기서 파일당 하나의 LONG 옵션 사양이 있는 배열 pfOptions로 바뀝니다. 파일 형식이 파일마다 다를 수 있기 때문입니다.

참고 항목

동일한 파일에 대해 SCC_FILETYPE_TEXT 및 SCC_FILETYPE_BINARY 옵션을 모두 지정하는 것은 유효하지 않지만 둘 다 지정하지 않는 것은 유효합니다. 둘 다 설정하지 않는 것은 SCC_FILETYPE_AUTO를 설정하는 것과 동일하며, 이 경우 소스 제어 플러그 인이 파일 형식을 자동으로 감지합니다.

다음은 pfOptions 배열에 사용된 플래그 목록입니다.

옵션	값	의미
SCC_FILETYPE_AUTO	0x00	소스 제어 플러그 인이 파일 형식을 감지해야 합니다.
SCC_FILETYPE_TEXT	0x01	ASCII 텍스트 파일을 나타냅니다.
SCC_FILETYPE_BINARY	0x02	ASCII 텍스트 이외의 파일 형식을 나타냅니다.
SCC_ADD_STORELATEST	0x04	파일의 최신 복사본만 저장하고 델타는 저장하지 않습니다.
SCC_FILETYPE_TEXT_ANSI	0x08	파일을 ANSI 텍스트로 처리합니다.
SCC_FILETYPE_UTF8	0x10	파일을 UTF8 형식의 유니코드 텍스트로 처리합니다.
SCC_FILETYPE_UTF16LE	0x20	파일을 UTF16 Little Endian 형식의 유니코드 텍스트로 처리합니다.
SCC_FILETYPE_UTF16BE	0x40	파일을 UTF16 Big Endian 형식의 유니코드 텍스트로 처리합니다.

참고 항목

• 소스 제어 플러그 인 API 함수