Share via

IVssBackupComponentsEx::GetWriterMetadataEx 메서드(vsbackup.h)

  • 아티클

GetWriterMetadataEx 메서드는 시스템에서 실행되는 특정 기록기 instance 대한 메타데이터를 반환합니다.

구문

HRESULT GetWriterMetadataEx(
  [in]  UINT                        iWriter,
  [out] VSS_ID                      *pidInstance,
  [out] IVssExamineWriterMetadataEx **ppMetadata
);

매개 변수

[in] iWriter

메타데이터를 검색할 기록기의 인덱스입니다. 이 매개 변수의 값은 0에서 n-1 사이의 정수입니다. 여기서 n 은 현재 시스템의 총 기록기 수입니다. n 값은 IVssBackupComponents::GetWriterMetadataCount 메서드에 의해 반환됩니다.

[out] pidInstance

메타데이터를 수집한 기록기의 instance 식별자를 수신하는 호출자가 할당한 변수의 주소입니다.

[out] ppMetadata

반환된 메타데이터를 포함하는 IVssExamineWriterMetadataEx 개체의 instance 대한 이중 간접 포인터입니다.

반환 값

다음은 이 메서드에 대한 유효한 반환 코드입니다.

값 의미
S_OK
 IVssExamineWriterMetadataEx 인터페이스 개체에 대한 포인터를 반환했습니다.
E_INVALIDARG
 매개 변수 값 중 하나가 잘못되었습니다.
E_OUTOFMEMORY
 호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_BAD_STATE
 백업 구성 요소 개체가 초기화되지 않았거나, 복원 작업 중에 이 메서드가 호출되었거나, 이 메서드가 올바른 시퀀스 내에서 호출되지 않았습니다.
VSS_E_INVALID_XML_DOCUMENT
 XML 문서가 잘못되었습니다. 자세한 내용은 이벤트 로그를 확인합니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.
VSS_E_OBJECT_NOT_FOUND
 iWriter 매개 변수는 유효한 기록기를 가리키지 않습니다.
VSS_E_UNEXPECTED
 예기치 않은 오류입니다. 오류 코드가 오류 로그 파일에 기록됩니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows Server 2008 R2 및 Windows 7까지 지원되지 않습니다. E_UNEXPECTED 대신 사용됩니다.

설명

GetWriterMetadataEx는 ppMetadata 매개 변수의 IVssExamineWriterMetadata 인터페이스 포인터 대신 IVssExamineWriterMetadataEx 인터페이스 포인터를 반환한다는 점을 제외하고 IVssBackupComponents::GetWriterMetadata 메서드와 동일합니다.

요청자는 비동기 IVssBackupComponents::GatherWriterMetadata 메서드를 호출하고 GetWriterMetadataEx를 호출하기 전에 완료되기를 기다려야 합니다.

GatherWriterMetadata 메서드는 복원 또는 백업 작업 전에 호출해야 하지만 GetWriterMetadataEx는 일반적으로 복원을 위해 호출되지 않습니다.

IVssExamineWriterMetadataEx 인터페이스가 GetWriterMetadataEx에서 반환된 IVssExamineWriterMetadataEx 메서드를 사용하여 검색된 구성 요소 정보(백업 작업 중)는 라이브 기록기 프로세스의 기록기 메타데이터 문서에서 제공됩니다.

이는 IVssBackupComponents::AddComponent 메서드를 호출하여 백업 구성 요소 문서에 저장된 GetWriterComponents(복원 작업 중)에서 반환한 정보와는 대조적입니다.

이 메서드의 호출자가 메타데이터에 대한 액세스를 마치면 IUnknown::Release를 호출해야 합니다.

요구 사항

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

추가 정보

IVssBackupComponents::GetWriterMetadata

IVssBackupComponentsEx

IVssExamineWriterMetadata

IVssExamineWriterMetadataEx