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

Статья
03/08/2023

[Начиная с 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

Share via