Compartilhar via


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

Confira também

GetDwordValue

GetGuidValue

IUPnPRemoteEndpointInfo