Метод IVssAdmin::RegisterProvider (vsadmin.h)

Статья
08/27/2023

Метод RegisterProvider регистрирует новый поставщик теневого копирования.

Синтаксис

HRESULT RegisterProvider(
  [in] VSS_ID            pProviderId,
  [in] CLSID             ClassId,
  [in] VSS_PWSZ          pwszProviderName,
  [in] VSS_PROVIDER_TYPE eProviderType,
  [in] VSS_PWSZ          pwszProviderVersion,
  [in] VSS_ID            ProviderVersionId
);

Параметры

[in] pProviderId

VSS_ID, который однозначно и постоянно идентифицирует поставщика. После его определения параметр ProviderId должен оставаться прежним, даже при обновлении редакции программного обеспечения. Параметр ProviderId следует изменять только в том случае, если функциональные возможности изменяются настолько, чтобы оба поставщика были активны в одной системе. Инициатор запроса может использовать параметр ProviderId , чтобы запросить использование определенного поставщика при создании теневой копии.

[in] ClassId

CLSID поставщика.

[in] pwszProviderName

Имя поставщика.

[in] eProviderType

Значение перечисления VSS_PROVIDER_TYPE , указывающее тип поставщика. Обратите внимание, что VSS_PROV_HARDWARE не является допустимым типом поставщика в версиях клиентских операционных систем Windows. Поставщики оборудования будут работать только в версиях операционной системы Windows Server.

[in] pwszProviderVersion

Версия поставщика.

[in] ProviderVersionId

VSS_ID, однозначно идентифицирующий эту версию поставщика. Сочетание параметров pProviderId и ProviderVersionId должно быть уникальным. Параметр ProviderVersionId может совпадать с параметром ProviderVersionId другого поставщика.

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

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Поставщик успешно зарегистрирован.
E_INVALIDARG	Одно или несколько значений параметра являются недопустимыми. Например, VSS_PROV_HARDWARE не является допустимым типом поставщика в версиях клиентских операционных систем Windows.
E_OUTOFMEMORY	Нехватка памяти или других системных ресурсов.
E_ACCESSDENIED	Вызывающий объект не является администратором.
VSS_E_PROVIDER_ALREADY_REGISTERED	Поставщик уже зарегистрирован на этом компьютере.
VSS_E_UNEXPECTED	Непредвиденная ошибка. Код ошибки записывается в файл журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED.

Если поставщик оборудования обновлен, приложение установки должно вызвать метод UnregisterProvider , чтобы отменить регистрацию устаревшей версии, а затем вызвать метод RegisterProvider для регистрации обновленного поставщика.

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

Требования

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

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

IVssAdmin

Отмена регистрацииProvider

Share via