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。 否则,该方法返回 WinError.h 中定义的 COM 错误代码之一。
注解
目前, bstrValueName 参数的唯一有效值为“RemoteAddress”, (Windows 7 仅) “HttpUserAgent”。 对于任何其他值,此方法将返回 COM 错误代码E_INVALIDARG。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista、Windows XP SP2 [仅限桌面应用] |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | upnphost.h |
| DLL | Upnphost.dll |