다음을 통해 공유


CVssWriter::OnIdentify 메서드(vswriter.h)

OnIdentify 메서드는 Identify 이벤트를 수신한 후 기록기에 의해 호출됩니다.

OnIdentify 는 가상 메서드입니다. CVssWriter 기본 클래스에 의해 구현되지만 파생 클래스에서 재정의할 수 있습니다.

구문

bool OnIdentify(
  [in] IVssCreateWriterMetadata *pMetadata
);

매개 변수

[in] pMetadata

기록기의 메타데이터를 생성하는 데 사용되는 IVssCreateWriterMetadata 개체에 대한 포인터입니다.

반환 값

기본 클래스에서 구현한 대로 OnIdentify 는 항상 true를 반환 합니다.

이 메서드의 다른 구현은 심각한 오류의 경우를 제외하고 true 를 반환해야 합니다. 심각한 오류가 발생하면 메서드는 false를 반환해야 합니다.

심각하지 않은 오류를 포함하여 오류가 발생하는 모든 경우 메서드는 오류의 정확한 이유를 보고하기 위해 이벤트 로그에 자세한 항목을 작성해야 합니다.

설명

CVssWriter 기본 클래스에 의한 이 메서드의 기본 구현은 다른 작업을 수행하지 않고 true를 반환합니다.

기록기는 이 메서드 또는 다른 CVssWriter(Ex)::OnXxx 콜백 메서드에서 예외를 throw해서는 안 됩니다.

작성기는 OnIdentify 또는 CVssWriterEx::OnIdentifyEx 메서드에서 CVssWriter::SetWriterFailure 메서드를 호출해서는 안 됩니다.

이 메서드가 CVssWriterEx2::GetSessionId 메서드를 호출하는 경우 이 메서드를 호출한 동일한 스레드에서 호출해야 합니다. 자세한 내용은 기록기 이벤트 처리를 참조하세요.

다른 애플리케이션에서 생성한 식별 이벤트에 대한 응답으로 작성자는 OnIdentify 처리기를 사용하여 IVsCreateWriterMetadata 인터페이스를 사용하여 관리하는 구성 요소에 대한 정보를 포함하는 기록기 메타데이터 문서를 만듭니다.

그런 다음 Identify 이벤트를 생성한 애플리케이션은 기록기 메타데이터 문서를 검색하고 IVssExamineWriterMetadata 인터페이스를 사용하여 기록기의 구성 요소 정보를 검사합니다.

식별 이벤트는 백업 또는 복원 시퀀스를 구성하는 이벤트 전에 필요합니다. 따라서 OnIdentify 는 백업 또는 복원 작업의 일부로 IVssBackupComponents::GatherWriterMetadata 에 대한 요청자의 호출에 대한 응답으로 Identify 이벤트를 처리하기 위해 가장 일반적으로 호출될 수 있습니다.

그러나 Identify 이벤트는 백업 또는 복원을 구성하는 이벤트 시퀀스의 일부가 아니며 VSS 서비스는 백업 또는 복원 시퀀스가 진행 중인 동안에도 생성을 방지하지 않습니다. instance 경우 VSS 관리 애플리케이션은 Identify 이벤트를 사용하여 시스템의 기록기 상태를 확인하고 표시합니다.

이 경우 작성기는 다음과 같은 방법으로 OnIdentify 구현을 사용하면 안 됩니다.

  • 백업 또는 복원 처리의 시작 부분으로
  • 기록기 상태에 대한 정보를 설정하거나 유지 관리하려면
이벤트와 기록기 상호 작용에 대한 자세한 내용은 기록기 이벤트 처리를 참조하세요.

OnIdentify에 전달된 IVssCreateWriterMetadata 개체의 수명 주기는 VSS 인프라에서 관리됩니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 vswriter.h(Vss.h, VsWriter.h 포함)
라이브러리 VssApi.lib

추가 정보

CVssWriter

IVssBackupComponents::GatherWriterMetadata

IVssCreateWriterMetadata