IVdsService：：GetObject 方法 (vds.h)

[从 Windows 8 和 Windows Server 2012 开始，虚拟磁盘服务 COM 接口由 Windows 存储管理 API 取代。]

返回所标识对象的对象指针。

语法

HRESULT GetObject(
  [in]  VDS_OBJECT_ID   ObjectId,
  [in]  VDS_OBJECT_TYPE type,
  [out] IUnknown        **ppObjectUnk
);

[in] ObjectId

所需对象的 GUID。

[in] type

一个VDS_OBJECT_TYPE枚举值，该值指定对象类型。不支持VDS_OT_UNKNOWN、VDS_OT_PROVIDER、VDS_OT_ASYNC、VDS_OT_ENUM和VDS_OT_OPEN_VDISK。

[out] ppObjectUnk

指向接收指向对象的 IUnknown 指针的缓冲区的指针。当不再需要指针时，调用方应通过调用 IUnknown：：Release 方法释放它。

此方法可以返回标准 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及特定于 VDS 的返回值。它还可以使用 HRESULT_FROM_WIN32 宏返回转换的系统错误代码。错误可能源自 VDS 本身或正在使用的基础 VDS 提供程序。可能的返回值包括以下内容。

返回代码/值	说明
VDS_E_OBJECT_NOT_FOUND 0x80042405L	找不到具有指定标识符和类型的对象。
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS 初始化失败。如果应用程序在服务完成初始化之前调用此方法，则会阻止该方法，直到初始化完成。如果初始化失败，则返回此错误。

VDS 通知返回对象标识符而不是对象指针。调用方使用此方法获取指向通知中引用的对象的指针。