IUPnPRemoteEndpointInfo::GetStringValue-Methode (upnphost.h)
Die GetStringValue-Methode ruft eine Zeichenfolge ab, die Informationen zu einer Anforderung oder einem Anforderer bereitstellt.
Syntax
HRESULT GetStringValue(
[in] BSTR bstrValueName,
[out] BSTR *pbstrValue
);
Parameter
[in] bstrValueName
Zeichenfolge, die die Kategorie der abzurufenden Informationen angibt.
[out] pbstrValue
Zeiger auf eine Zeichenfolge, deren Bedeutung vom Wert von bstrValueName abhängt.
Wenn bstrValueName "RemoteAddress" ist, ist die Zeichenfolge die IP-Adresse des Anforderers. Windows 7: Um den HTTP UserAgent-Header abzurufen, legen Sie bstrValueName auf "HttpUserAgent" fest.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der com-Fehlercodes zurück, die in WinError.h definiert sind.
Hinweise
Derzeit sind die einzigen gültigen Werte für den bstrValueName-Parameter "RemoteAddress" und (nur Windows 7) "HttpUserAgent". Für jeden anderen Wert gibt diese Methode den COM-Fehlercode E_INVALIDARG zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | upnphost.h |
| DLL | Upnphost.dll |