IVssExamineWriterMetadata：：GetIdentity 方法 (vsbackup.h)

  • 项目

GetIdentity 方法获取有关特定编写器实例的基本信息。

语法

HRESULT GetIdentity(
  [out] VSS_ID          *pidInstance,
  [out] VSS_ID          *pidWriter,
  [out] BSTR            *pbstrWriterName,
  [out] VSS_USAGE_TYPE  *pUsage,
  [out] VSS_SOURCE_TYPE *pSource
);

参数

[out] pidInstance

调用方分配的变量的地址，该变量接收编写器的实例标识符。

[out] pidWriter

调用方分配的变量的地址，该变量接收编写器的类标识符。

[out] pbstrWriterName

调用方分配的变量的地址，该变量接收包含编写器名称的字符串。

[out] pUsage

调用方分配的变量的地址，该变量接收 VSS_USAGE_TYPE 枚举值，该值指定编写器管理的数据在主机系统上的使用方式。

[out] pSource

调用方分配的变量的地址，该变量接收指定编写器管理的数据类型 的VSS_SOURCE_TYPE 枚举值。

返回值

下面是此方法的有效返回代码。

值 含义
S_OK
 已成功返回标识信息。
E_INVALIDARG
 其中一个参数值无效。
E_OUTOFMEMORY
 调用方内存或其他系统资源不足。
VSS_E_INVALID_XML_DOCUMENT
 XML 文档无效。 有关详细信息，请查看事件日志。 有关详细信息，请参阅 VSS 下的事件和错误处理。
VSS_E_UNEXPECTED
 意外错误。 错误代码记录在错误日志文件中。 有关详细信息，请参阅 VSS 下的事件和错误处理。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 在 Windows Server 2008 R2 和 Windows 7 之前不支持此值。 改用E_UNEXPECTED。

注解

调用方必须通过调用 SysFreeString 释放 pbstrWriterName 参数保留的内存。

IVssExamineWriterMetadata 接口可能来自存储的编写器状态信息， (调用 CreateVssExamineWriterMetadata) 创建。 如果是这种情况，则以下情况为 true：

  • pidInstance 在实时作家方面可能没有任何意义。
  • 如果 pidWriter 与任何实时编写器的编写器类不匹配，则请求者不应使用该编写器的组件。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h)
Library VssApi.lib

另请参阅

CreateVssExamineWriterMetadata

IVssExamineWriterMetadata

VSS_SOURCE_TYPE

VSS_USAGE_TYPE