共用方式為


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