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으로 다시 설정해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | vswriter.h |