Метод IVdsAdmin::RegisterProvider (vdshwprv.h)

Статья
03/08/2023

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

Регистрирует указанный поставщик оборудования в VDS. Поставщики оборудования вызывают этот метод.

Синтаксис

HRESULT RegisterProvider(
  [in] VDS_OBJECT_ID     providerId,
  [in] CLSID             providerClsid,
  [in] LPWSTR            pwszName,
  [in] VDS_PROVIDER_TYPE type,
  [in] LPWSTR            pwszMachineName,
  [in] LPWSTR            pwszVersion,
  [in] GUID              guidVersionId
);

Параметры

[in] providerId

GUID поставщика оборудования.

[in] providerClsid

Идентификатор класса COM (Clsid) поставщика оборудования.

[in] pwszName

Имя поставщика оборудования в виде строки с нулевым завершением, доступной для чтения человеком.

[in] type

Типы поставщиков, перечисляемые VDS_PROVIDER_TYPE. Используйте значение VDS_PT_HARDWARE для регистрации поставщика оборудования в VDS.

[in] pwszMachineName

Имя компьютера, на котором выполняется поставщик оборудования; строка, завершающаяся значением NULL, читаемая человеком. Используйте значение NULL для ссылки на текущий компьютер.

[in] pwszVersion

Версия поставщика в виде строки с нулевым завершением, доступной для чтения человеком.

[in] guidVersionId

ИДЕНТИФИКАТОР GUID для этой версии поставщика.

Возвращаемое значение

Этот метод может возвращать стандартные значения HRESULT, такие как E_INVALIDARG или E_OUTOFMEMORY, а также возвращаемые значения VDS. Он также может возвращать коды преобразованных системных ошибок с помощью макроса HRESULT_FROM_WIN32 . Ошибки могут возникать из самого VDS или из используемого базового поставщика VDS . Возможные возвращаемые значения включают следующие.

Возвращаемый код/значение	Описание
VDS_E_ALREADY_REGISTERED 0x80042403L	ProviderId уже зарегистрирован. В любой момент времени можно зарегистрировать только одну версию поставщика.

Требования

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

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

IVdsAdmin

IVdsAdmin::UnregisterProvider

VDS_PROVIDER_TYPE

Share via