Метод IVdsService::GetObject (vds.h)

Статья
03/08/2023

[Начиная с Windows 8 и Windows Server 2012 COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]

Возвращает указатель объекта для идентифицированного объекта.

Синтаксис

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 возвращают идентификатор объекта вместо указателя объекта. Вызывающие объекты используют этот метод для получения указателя на объект, на который ссылается уведомление.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	vds.h
Библиотека	Uuid.lib

См. также раздел

IVdsService

VDS_OBJECT_TYPE