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 |