다음을 통해 공유

SccGetEvents 함수

  • 아티클

이 함수는 큐에 대기 중인 이벤트를 검색합니다.

구문

SCCRTN SccGetEvents (
   LPVOID pvContext,
   LPSTR  lpFileName,
   LPLONG lpStatus,
   LPLONG pnEventsRemaining
);

매개 변수

pvContext

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

lpFileName

[in, out] 소스 제어 플러그 인이 반환된 파일 이름(최대 _MAX_PATH 문자)을 배치하는 버퍼입니다.

lpStatus

[in, out] 상태 코드를 반환합니다(가능한 값은 파일 상태 코드 참조).

pnEventsRemaining

[in, out] 이 호출 후 큐에 남아 있는 항목 수를 반환합니다. 이 숫자가 크면 호출자가 SccQueryInfo를 호출하여 모든 정보를 한 번에 가져올 수 있습니다.

반환 값

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

값 Description
SCC_OK 이벤트 가져오기에 성공했습니다.
SCC_E_OPNOTSUPPORTED 이 함수는 지원되지 않습니다.
SCC_E_NONSPECIFICERROR 일반적인 오류입니다.

설명

이 함수는 소스 제어 중인 파일에 대한 상태 업데이트가 있는지 확인하기 위해 유휴 처리 중에 호출됩니다. 소스 제어 플러그 인은 알고 있는 모든 파일의 상태를 유지하며 플러그 인에서 상태 변경을 알릴 때마다 상태 및 관련 파일이 큐에 저장됩니다. SccGetEvents가 호출되면 큐의 최상위 요소가 검색되고 반환됩니다. 이 함수는 이전에 캐시된 정보만 반환하도록 제한되며 매우 빠른 처리가 필요합니다(즉, 디스크를 읽거나 소스 제어 시스템에 상태를 요청하지 않음). 그렇지 않으면 IDE의 성능이 저하되기 시작할 수 있습니다.

보고할 상태 업데이트가 없는 경우 소스 제어 플러그 인은 lpFileName이 가리키는 버퍼에 빈 문자열을 저장합니다. 그렇지 않으면 플러그 인이 상태 정보가 변경된 파일의 전체 경로 이름을 저장하고 적절한 상태 코드(파일 상태 코드에 자세히 설명된 값 중 하나)를 반환합니다.

참고 항목