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


Метод IWSDDeviceHost::RetireService (wsdhost.h)

Отменяет регистрацию объекта службы, зарегистрированного с помощью RegisterService , и удаляет службу из метаданных узла устройства.

Синтаксис

HRESULT RetireService(
  [in] LPCWSTR pszServiceId
);

Параметры

[in] pszServiceId

Идентификатор удаляемой службы.

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

Возможные возвращаемые значения включают, помимо прочего, следующие:

Код возврата Описание
S_OK
Метод успешно завершен.
E_POINTER
pszServiceId имеет значение NULL.
E_INVALIDARG
Длина в символах pszServiceId превышает WSD_MAX_TEXT_LENGTH (8192), или pszServiceId не найден в списке зарегистрированных служб.
E_FAIL
Сбой метода. Возможно, произошел сбой, так как узел не был инициализирован. Вызовите init для инициализации узла устройства.

Комментарии

Узел устройства освобождает ссылку на объект службы после отмены регистрации службы. Объект службы не будет получать обратные вызовы после завершения действия RetireService .

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header wsdhost.h (включая Wsdapi.h)
DLL Wsdapi.dll

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

IWSDDeviceHost