(vds.h) IVdsService：：GetObject 方法

[從 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 提供者。可能的傳回值包括下列專案。

傳回碼/值	Description
VDS_E_OBJECT_NOT_FOUND 0x80042405L	找不到具有指定識別碼和型別的物件。
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS 無法初始化。如果應用程式在服務完成初始化之前呼叫這個方法，則會封鎖方法，直到初始化完成為止。如果初始化失敗，則會傳回此錯誤。

VDS 通知會傳回物件標識碼，而不是對象指標。呼叫端會使用這個方法來取得通知中所參考物件的指標。