IWSDTransportAddress::GetTransportAddress method (wsdbase.h)

Article
02/22/2024

Gets a pointer to a string representation of the address object. The format of the string varies, and is determined by the implementing interface (either IWSDHttpAddress or IWSDUdpAddress).

Syntax

HRESULT GetTransportAddress(
  [out] LPCWSTR *ppszAddress
);

Parameters

[out] ppszAddress

String representation of the address object. Do not deallocate this pointer.

Return value

This method can return one of these values.

Possible return values include, but are not limited to, the following.

Return code	Description
S_OK	Method completed successfully.
E_POINTER	ppszAddress is NULL.
S_FALSE	The transport address has not yet been set. To set the transport address, call SetTransportAddress with a non-NULL address.

Remarks

The string returned by this method may contain an IPv4 or unbracketed IPv6 address such as "fe80::1". It may also contain a bracketed IPv6 address that includes the port such as "[fe80::1]:1234". The caller should parse the string carefully to account for both possibilities.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	wsdbase.h (include Wsdapi.h)
DLL	Wsdapi.dll

Share via