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 |
---|---|
|
IP (IP versão 4) |
|
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 |