Método IWSDTransportAddress::GetTransportAddressEx (wsdbase.h)

Obtém um ponteiro para uma representação de cadeia de caracteres do objeto de endereço. O formato da cadeia de caracteres varia e é determinado pela interface de implementação ( IWSDHttpAddress ou IWSDUdpAddress).

Sintaxe

HRESULT GetTransportAddressEx(
  [in]  BOOL    fSafe,
  [out] LPCWSTR *ppszAddress
);

Parâmetros

[in] fSafe

Especifica se o identificador de escopo de um endereço IPv6 está incluído na cadeia de caracteres ppszAddress retornada . Por exemplo, se o objeto de endereço representar um endereço local de link IPv6 e fSafe for FALSE, o identificador de escopo IPv6 será incluído na cadeia de caracteres ppszAddress retornada.

Se o objeto de endereço representar um endereço IPv4 ou um nome de host, esse parâmetro será ignorado.

[out] ppszAddress

Representação de cadeia de caracteres do objeto de endereço. Não desaloque esse ponteiro.

Valor retornado

Esse método pode retornar um desses valores.

Os possíveis valores retornados incluem, mas não se limitam a, o seguinte.

Código de retorno	Descrição
S_OK	Método concluído com êxito.
E_POINTER	ppszAddress é NULL.
S_FALSE	O endereço de transporte ainda não foi definido. Para definir o endereço de transporte, chame SetTransportAddress com um endereço não NULL .

Comentários

A cadeia de caracteres retornada por esse método pode conter um endereço IPv4 ou IPv6 não armazenado, como "fe80::1". Ele também pode conter um endereço IPv6 entre colchetes que inclui a porta como "[fe80::1]:1234". O chamador deve analisar a cadeia de caracteres cuidadosamente para considerar ambas as possibilidades.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wsdbase.h (inclua Wsdapi.h)
DLL	Wsdapi.dll

Confira também

IWSDTransportAddress