IVssBackupComponents::GetWriterMetadata 메서드(vsbackup.h)

아티클
08/27/2023

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

구문

HRESULT GetWriterMetadata(
  [in]  UINT                      iWriter,
  [out] VSS_ID                    *pidInstance,
  [out] IVssExamineWriterMetadata **ppMetadata
);

매개 변수

[in] iWriter

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

[out] pidInstance

메타데이터를 수집한 기록기의 instance 식별자에 대한 포인터입니다.

[out] ppMetadata

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

반환 값

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

값	의미
S_OK	IVssExamineWriterMetadata 인터페이스 개체에 대한 포인터를 반환했습니다.
E_INVALIDARG	매개 변수 값 중 하나가 잘못되었습니다.
E_OUTOFMEMORY	호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_BAD_STATE	백업 구성 요소 개체가 초기화되지 않았거나, 복원 작업 중에 이 메서드가 호출되었거나, 이 메서드가 올바른 시퀀스 내에서 호출되지 않았습니다.
VSS_E_INVALID_XML_DOCUMENT	XML 문서가 잘못되었습니다. 자세한 내용은 이벤트 로그를 확인합니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.
VSS_E_OBJECT_NOT_FOUND	지정된 섀도 복사본이 없습니다.
VSS_E_UNEXPECTED	예기치 않은 오류입니다. 오류 코드가 오류 로그 파일에 기록됩니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows Server 2008 R2 및 Windows 7까지 지원되지 않습니다. 대신 E_UNEXPECTED 사용됩니다.

설명

요청자는 비동기 작업 IVssBackupComponents::GatherWriterMetadata를 호출하고 GetWriterMetadata를 호출하기 전에 완료되기를 기다려야 합니다.

복원 또는 백업 작업 전에 IVssBackupComponents::GatherWriterMetadata 를 호출해야 하지만 GetWriterMetadata 는 일반적으로 복원을 위해 호출되지 않습니다.

IVssExamineWriterMetadata::GetComponent를 사용하여 검색된 구성 요소 정보(백업 작업 중) GetWriterMetadata에서 IVssExamineWriterMetadata 인터페이스가 반환된 경우 라이브 작성기 프로세스의 기록기 메타데이터 문서에서 가져옵니다.

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

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

요구 사항

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