IVssExpressWriter::CreateMetadata 메서드(vswriter.h)

빠른 작성기 메타데이터 개체를 만들고 IVssCreateExpressWriterMetadata 인터페이스 포인터를 반환합니다.

구문

HRESULT CreateMetadata(
  [in]  VSS_ID                          writerId,
  [in]  LPCWSTR                         writerName,
  [in]  VSS_USAGE_TYPE                  usageType,
  [in]  DWORD                           versionMajor,
  [in]  DWORD                           versionMinor,
  [in]  DWORD                           reserved,
  [out] IVssCreateExpressWriterMetadata **ppMetadata
);

매개 변수

[in] writerId

기록기 클래스의 GUID(Globally Unique Identifier)입니다.

[in] writerName

기록기 클래스의 이름을 포함하는 null로 끝나는 와이드 문자열입니다. 이 문자열은 지역화되지 않습니다.

[in] usageType

기록기에서 관리하는 데이터가 호스트 시스템에서 사용되는 방식을 나타내는 VSS_USAGE_TYPE 열거형 값입니다. 이 매개 변수에 유효한 값은 VSS_UT_BOOTABLESYSTEMSTATE, VSS_UT_SYSTEMSERVICE 및 VSS_UT_USERDATA.

[in] versionMajor

기록기 애플리케이션의 주 버전입니다. 자세한 내용은 주의 섹션을 참조하세요.

[in] versionMinor

작성기 애플리케이션의 부 버전입니다. 자세한 내용은 주의 섹션을 참조하세요.

[in] reserved

이 매개 변수는 시스템 사용을 위해 예약되어 있습니다.

[out] ppMetadata

새로 만든 Express Writer 메타데이터에 대한 IVssCreateExpressWriterMetadata 인터페이스 포인터를 수신하는 변수에 대한 포인터입니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

versionMajor 및 versionMajor 매개 변수는 다음 VSS 규칙에 따라 기록기 주 및 부 버전 번호를 지정하는 데 사용됩니다.

• 기록기의 릴리스된 버전에 요청자와의 상호 작용에 영향을 주는 사소한 변경 내용이 포함될 때마다 기록기의 부 버전 번호가 하나씩 증가해야 합니다. 예를 들어 기록기 QFE 또는 서비스 팩의 파일 사양을 수정하면 부 버전 번호가 증가하는 것을 정당화할 수 있습니다. 그러나 작성기의 베타 버전 또는 릴리스 후보 버전 간의 변경은 부 버전 번호의 변경을 정당화하지 않습니다.
• 기록기의 릴리스된 버전에 중요한 변경 내용이 포함될 때마다 기록기의 주 버전 번호가 하나씩 증가해야 합니다. 예를 들어 새 버전의 기록기를 사용하여 백업된 데이터를 이전 버전의 기록기를 사용하여 복원할 수 없는 경우 새 작성기의 주 버전 번호가 증가해야 합니다.
• 주 버전 번호가 증가될 때마다 부 버전 번호를 0으로 다시 설정해야 합니다.

기록기에서 버전 번호를 지정하지 않으면 VSS는 기본 버전 번호 0.0을 할당합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	vswriter.h

추가 정보

CreateVssExpressWriter

IVssExpressWriter