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。 否则,该方法返回 WinError.h 中定义的 COM 错误代码之一。

注解

目前, bstrValueName 参数的唯一有效值为“RemoteAddress”, (Windows 7 仅) “HttpUserAgent”。 对于任何其他值,此方法将返回 COM 错误代码E_INVALIDARG。

要求

要求
最低受支持的客户端 Windows Vista、Windows XP SP2 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 upnphost.h
DLL Upnphost.dll

另请参阅

GetDwordValue

GetGuidValue

IUPnPRemoteEndpointInfo