Método IUPnPRemoteEndpointInfo::GetStringValue (upnphost.h)
O método GetStringValue obtém uma cadeia de caracteres que fornece informações sobre uma solicitação ou um solicitante.
Sintaxe
HRESULT GetStringValue(
[in] BSTR bstrValueName,
[out] BSTR *pbstrValue
);
Parâmetros
[in] bstrValueName
Cadeia de caracteres que especifica a categoria de informações a serem recuperadas.
[out] pbstrValue
Ponteiro para uma cadeia de caracteres, cujo significado depende do valor de bstrValueName.
Se bstrValueName for "RemoteAddress", a cadeia de caracteres será o endereço IP do solicitante. Windows 7: Para recuperar o cabeçalho UserAgent HTTP, defina bstrValueName como "HttpUserAgent".
Retornar valor
Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, o método retornará um dos códigos de erro COM definidos em WinError.h.
Comentários
Atualmente, os únicos valores válidos para o parâmetro bstrValueName são "RemoteAddress" e (somente Windows 7) "HttpUserAgent". Para qualquer outro valor, esse método retornará o código de erro COM E_INVALIDARG.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | upnphost.h |
| DLL | Upnphost.dll |