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


Метод IVdsServiceLoader::LoadService (vds.h)

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

Запускает VDS на указанном компьютере и возвращает указатель на объект службы.

Синтаксис

HRESULT LoadService(
  [in]  LPWSTR      pwszMachineName,
  [out] IVdsService **ppService
);

Параметры

[in] pwszMachineName

Этот параметр должен иметь значение NULL.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista и Windows Server 2003: Этот параметр содержит имя главного компьютера. Установка значения NULL приводит к загрузке и инициализации VDS на локальном узле.

[out] ppService

Адрес указателя интерфейса IVdsService . Вызывающие элементы должны освободить интерфейс, когда он больше не нужен, путем вызова метода IUnknown::Release .

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

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

Код возврата Описание
S_OK
Служба успешно запущена.

Комментарии

Хотя S_OK указывает, что VDS успешно запущена, инициализация службы может быть неполной при возврате метода. По этой причине после вызова этого метода необходимо вызвать метод IVdsService::WaitForServiceReady , чтобы дождаться завершения инициализации VDS.

Пример кода см. в разделе Загрузка VDS.

Требования

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

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

IVdsService

IVdsService::WaitForServiceReady

IVdsServiceLoader