Поделиться через


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

[Начиная с 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 уже зарегистрирован. В любой момент времени можно зарегистрировать только одну версию поставщика.

Комментарии

При необходимости вызовите UnregisterProvider , чтобы удалить поставщика перед регистрацией новой версии.

Внутрипроцессный поставщик вызывает этот метод из DllRegisterServer; тогда как внепроцессный поставщик вызывает из функции WinMain .

Поставщики оборудования не должны останавливать работу во время работы VDS.

Требования

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

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

IVdsAdmin

IVdsAdmin::UnregisterProvider

VDS_PROVIDER_TYPE