Функция WSDCreateDeviceProxyAdvanced (wsdclient.h)

Статья
08/28/2023

Создает прокси-сервер устройства и возвращает указатель на интерфейс IWSDDeviceProxy .

Синтаксис

HRESULT WSDCreateDeviceProxyAdvanced(
  [in]  LPCWSTR         pszDeviceId,
        IWSDAddress     *pDeviceAddress,
  [in]  LPCWSTR         pszLocalId,
  [in]  IWSDXMLContext  *pContext,
  [out] IWSDDeviceProxy **ppDeviceProxy
);

Параметры

[in] pszDeviceId

Логический или физический адрес устройства. Логический адрес имеет вид urn:uuid:{guid}. Физический адрес — это универсальный код ресурса (URI) с префиксом http или https. Если этот адрес является универсальным кодом ресурса (URI) с префиксом https, то прокси-сервер будет использовать протокол SSL/TLS.

Если pszDeviceId или pszLocalId является URL-адресом с префиксом https, то оба URL-адреса должны быть идентичными. Если это не так, WSDCreateDeviceProxyAdvanced вернет E_INVALIDARG.

Адрес устройства может иметь префикс символ @. Если pszDeviceId начинается с @, эта функция не получает метаданные устройства при создании прокси-сервера устройства.

pDeviceAddress

Интерфейс IWSDAddress , определяющий адрес транспорта устройства. При указании pDeviceAddress можно создать прокси-сервер устройства, не требуя разрешения логического адреса, передаваемого в pszDeviceId. Этот параметр может иметь значение NULL.

[in] pszLocalId

Логический или физический адрес клиента, который используется для идентификации прокси-сервера и выполнения роли конечной точки приемника событий. Логический адрес имеет вид urn:uuid:{guid}.

Если клиент использует безопасный канал для получения событий, то адрес представляет собой URI с префиксом https. Этот универсальный код ресурса (URI) должен указывать порт 5358, так как этот порт зарезервирован для безопасных подключений с помощью WSDAPI. Перед вызовом WSDCreateDeviceProxyAdvanced в порте должен быть настроен SSL-сертификат сервера. Дополнительные сведения о конфигурации портов см. в разделе HttpSetServiceConfiguration.

[in] pContext

Интерфейс IWSDXMLContext , определяющий пользовательские типы сообщений или пространства имен.

Если значение РАВНО NULL, используется контекст по умолчанию, представляющий встроенные типы сообщений и пространства имен.

[out] ppDeviceProxy

Указатель на интерфейс IWSDDeviceProxy , который используется для представления удаленного устройства WSD для клиентских приложений и ПО промежуточного слоя.

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

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

Код возврата	Описание
S_OK	Метод успешно завершен.
E_INVALIDARG	pszDeviceId имеет значение NULL, pszLocalId — NULL, длина в символах pszDeviceId превышает WSD_MAX_TEXT_LENGTH (8192), длина символов pszLocalId превышает WSD_MAX_TEXT_LENGTH (8192), или pszDeviceId указывает на URI с префиксом https, и этот URL-адрес не соответствует URI, переданного pszLocalId.
E_POINTER	ppDeviceProxy имеет значение NULL.
E_OUTOFMEMORY	Недостаточно памяти для завершения операции.

Эта функция также извлекает метаданные устройства, если только параметр pszDeviceId не начинается с символа @. Чтобы получить метаданные устройства после создания прокси-сервера устройства, вызовите IWSDDeviceProxy::BeginGetMetadata и IWSDDeviceProxy::EndGetMetadata для возвращенного объекта IWSDDeviceProxy .

Сведения об устранении неполадок WSDCreateDeviceProxyДополнение вызовов функций см. в статье Устранение неполадок приложений WSDAPI.

Требования


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

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

Устранение неполадок с приложениями WSDAPI

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