Метод IUPnPRemoteEndpointInfo::GetStringValue (upnphost.h)
Метод GetStringValue получает строку, которая предоставляет сведения о запросе или инициаторе запроса.
Синтаксис
HRESULT GetStringValue(
[in] BSTR bstrValueName,
[out] BSTR *pbstrValue
);
Параметры
[in] bstrValueName
Строка, указывающая категорию извлекаемых сведений.
[out] pbstrValue
Указатель на строку, значение которой зависит от значения bstrValueName.
Если bstrValueName имеет значение "RemoteAddress", строка является IP-адресом запрашивающего объекта. Windows 7: Чтобы получить заголовок HTTP UserAgent, присвойте bstrValueName значение "HttpUserAgent".
Возвращаемое значение
Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае метод возвращает один из кодов com-ошибок, определенных в WinError.h.
Комментарии
В настоящее время единственными допустимыми значениями для параметра bstrValueName являются RemoteAddress и (только в Windows 7) HttpUserAgent. Для любого другого значения этот метод возвращает код ошибки COM E_INVALIDARG.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | upnphost.h |
| DLL | Upnphost.dll |