IVdsService::GetObject メソッド (vds.h)

[Windows 8とWindows Server 2012以降、Virtual Disk Service COM インターフェイスは Windows Storage Management 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 メソッドを呼び出してポインターを解放する必要があります。

このメソッドは、E_INVALIDARGやE_OUTOFMEMORYなどの標準の HRESULT 値と、VDS 固有の戻り値を返すことができます。また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステムエラーコードを返すこともできます。エラーは、VDS 自体または使用されている基になる VDS プロバイダーから発生する可能性があります。可能な戻り値は次のとおりです。

リターンコード/値	Description
VDS_E_OBJECT_NOT_FOUND 0x80042405L	指定した識別子と型を持つオブジェクトが見つかりません。
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS の初期化に失敗しました。サービスの初期化が完了する前にアプリケーションがこのメソッドを呼び出すと、初期化が完了するまでメソッドはブロックされます。初期化に失敗した場合、このエラーが返されます。

VDS 通知は、オブジェクトポインターではなくオブジェクト識別子を返します。呼び出し元は、このメソッドを使用して、通知で参照されているオブジェクトへのポインターを取得します。