Método IUPnPRemoteEndpointInfo::GetStringValue (upnphost.h)
El método GetStringValue obtiene una cadena que proporciona información sobre una solicitud o un solicitante.
Sintaxis
HRESULT GetStringValue(
[in] BSTR bstrValueName,
[out] BSTR *pbstrValue
);
Parámetros
[in] bstrValueName
Cadena que especifica la categoría de información que se va a recuperar.
[out] pbstrValue
Puntero a una cadena, cuyo significado depende del valor de bstrValueName.
Si bstrValueName es "RemoteAddress", la cadena es la dirección IP del solicitante. Windows 7: Para recuperar el encabezado Http UserAgent, establezca bstrValueName en "HttpUserAgent".
Valor devuelto
Si el método se realiza correctamente, el valor devuelto es S_OK. De lo contrario, el método devuelve uno de los códigos de error COM definidos en WinError.h.
Comentarios
Actualmente, los únicos valores válidos para el parámetro bstrValueName son "RemoteAddress" y (solo Windows 7) "HttpUserAgent". Para cualquier otro valor, este método devolverá el código de error COM E_INVALIDARG.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | upnphost.h |
| Archivo DLL | Upnphost.dll |