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 |