다음을 통해 공유

SccQueryInfo 함수

  • 아티클

이 함수는 소스 제어에서 선택한 파일 집합에 대한 상태 정보를 가져옵니다.

구문

SCCRTN SccQueryInfo(
   LPVOID  pvContext,
   LONG    nFiles,
   LPCSTR* lpFileNames,
   LPLONG  lpStatus
);

매개 변수

pvContext

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

nFiles

[in] lpFileNames 배열에 지정된 파일 수와 lpStatus 배열의 길이입니다.

lpFileNames

[in] 쿼리할 파일 이름의 배열입니다.

lpStatus

[in, out] 소스 제어 플러그 인이 각 파일의 상태 플래그를 반환하는 배열입니다. 자세한 내용은 파일 상태 코드를 참조하세요.

Return Value

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

값 Description
SCC_OK 쿼리에 성공했습니다.
SCC_E_ACCESSFAILURE 네트워크 또는 경합 문제로 인해 소스 제어 시스템에 액세스하는 데 문제가 발생했습니다. 다시 시도하는 것이 좋습니다.
SCC_E_PROJNOTOPEN 프로젝트가 소스 제어에서 열려 있지 않습니다.
SCC_E_NONSPECIFICERROR 일반적인 오류입니다.

설명

lpFileName이 빈 문자열이면 현재 업데이트할 상태 정보가 없습니다. 그렇지 않으면 상태 정보가 변경되었을 수 있는 파일의 전체 경로 이름입니다.

반환 배열은 SCC_STATUS_xxxx 비트의 비트 마스크일 수 있습니다. 자세한 내용은 파일 상태 코드를 참조하세요. 소스 제어 시스템은 모든 비트 형식을 지원하지 않을 수 있습니다. 예를 들어 SCC_STATUS_OUTOFDATE가 제공되지 않으면 비트는 설정되지 않습니다.

이 함수를 사용하여 파일을 체크 아웃할 때 다음 MSSCCI 상태 요구 사항에 유의하세요.

  • SCC_STATUS_OUTBYUSER는 현재 사용자가 파일을 체크 아웃했을 때 설정됩니다.

  • SCC_STATUS_OUTBYUSER가 설정되지 않으면 SCC_STATUS_CHECKEDOUT을 설정할 수 없습니다.

  • SCC_STATUS_CHECKEDOUT은 파일이 지정된 작업 디렉터리로 체크 아웃된 경우에만 설정됩니다.

  • 현재 사용자가 작업 디렉터리가 아닌 디렉터리로 파일을 체크 아웃한 경우 SCC_STATUS_OUTBYUSER가 설정되지만 SCC_STATUS_CHECKEDOUT은 설정되지 않습니다.

참고 항목