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

아티클
03/03/2024

GetWriterComponents 메서드는 요청자의 백업 구성 요소 문서에 저장된 지정된 작성기의 해당 구성 요소에 대한 정보를 반환하는 데 사용됩니다.

구문

HRESULT GetWriterComponents(
  [in]  UINT                    iWriter,
  [out] IVssWriterComponentsExt **ppWriter
);

매개 변수

[in] iWriter

쿼리할 작성기의 인덱스입니다. 0에서 n-1 사이의 숫자입니다. 여기서 n 은 IVssBackupComponents::GetWriterComponentsCount에서 반환되는 값입니다.

[out] ppWriter

반환된 구성 요소 정보를 받을 IVssWriterComponentsExt 인터페이스 개체에 대한 이중 간접 포인터입니다.

반환 값

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

값	의미
S_OK	IVssWriterComponentsExt 인터페이스 개체에 대한 포인터를 반환했습니다.
E_INVALIDARG	매개 변수 값 중 하나가 잘못되었습니다.
E_OUTOFMEMORY	호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다.
VSS_E_BAD_STATE	백업 구성 요소 개체가 초기화되지 않았거나, 복원 작업 중에 이 메서드가 호출되었거나, 이 메서드가 올바른 시퀀스 내에서 호출되지 않았습니다.
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 사용됩니다.

설명

이 메서드의 호출자는 구성 요소 정보에 대한 액세스가 완료되면 IUnknown::Release 를 호출해야 합니다.

GetWriterComponents는IVssBackupComponents::AddComponent에 대한 이전 호출을 통해 백업 구성 요소 문서에 저장된 구성 요소에 대한 구성 요소 정보를 검색합니다.

백업 구성 요소 문서에 저장된 구성 요소의 정보가 정적이지 않습니다. 작성기가 복원 중에 구성 요소를 업데이트하는 경우 해당 변경 내용은 GetWriterComponents에서 검색한 구성 요소에 반영됩니다. 이는 IVssExamineWriterMetadata::GetComponent에서 반환된 IVssWMComponent 개체에 있는 구성 요소 정보와는 대조적입니다. 해당 정보는 읽기 전용이며 기록기 프로세스의 기록기 메타데이터 문서에서 제공됩니다.

다음 IVssBackupComponents 메서드로 인해 GetWriterComponents에서 반환된 인터페이스 포인터가 더 이상 유효하지 않으므로 pWriterComponents 매개 변수에 반환되는 IVssWriterComponentsExt 인터페이스 포인터는 캐시되지 않아야 합니다.

IVssBackupComponents::P repareForBackup IVssBackupComponents::D oSnapshotSet IVssBackupComponents::BackupComplete IVssBackupComponents::P iVssBackupComponents::P ostRestoreGetWriterComponents를 호출하여 IVssWriterComponentsExt 인터페이스 포인터를 검색한 후 이러한 메서드 중 하나를 호출하는 경우 해당 포인터를 다시 사용할 수 없습니다. 더 이상 유효하지 않으므로 대신 GetWriterComponents를 다시 호출하여 새 IVssWriterComponentsExt 인터페이스 포인터를 검색해야 합니다.

요구 사항

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