Compartilhar via


Método IUPnPRemoteEndpointInfo::GetDwordValue (upnphost.h)

O método GetDwordValue obtém um valor de 4 bytes que fornece informações sobre uma solicitação ou um solicitante.

Sintaxe

HRESULT GetDwordValue(
  [in]  BSTR  bstrValueName,
  [out] DWORD *pdwValue
);

Parâmetros

[in] bstrValueName

Cadeia de caracteres que especifica a categoria de informações a serem recuperadas.

[out] pdwValue

Ponteiro para um valor de 4 bytes, cujo significado depende do valor de bstrValueName.

Se bstrValueName for "AddressFamily", o valor de 4 bytes indicará o formato do endereço IP do solicitante da seguinte maneira. Os valores são definidos em Winsock2.h.

Valor Significado
AF_INET
IP (IP versão 4)
AF_INET6
IP6 (IP versão 6)

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, o único valor válido para o parâmetro bstrValueName é "AddressFamily". 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

GetGuidValue

GetStringValue

IUPnPRemoteEndpointInfo