IWSDTransportAddress::GetTransportAddressEx 方法 (wsdbase.h)
取得位址物件之字串表示的指標。 字串的格式會有所不同,而且取決於實作介面 (IWSDHttpAddress 或 IWSDUdpAddress) 。
語法
HRESULT GetTransportAddressEx(
[in] BOOL fSafe,
[out] LPCWSTR *ppszAddress
);
參數
[in] fSafe
指定傳回的 ppszAddress 字串中是否包含 IPv6 位址的範圍識別碼。 例如,如果位址物件代表 IPv6 連結本機位址, 而 fSafe 為 FALSE,則傳回的 ppszAddress 字串中將會包含 IPv6 範圍識別碼。
如果位址物件代表 IPv4 位址或主機名稱,則會忽略此參數。
[out] ppszAddress
位址物件的字串表示。 請勿解除配置此指標。
傳回值
這個方法可以傳回下列其中一個值。
可能的傳回值包括但不限於下列各項。
傳回碼 | 描述 |
---|---|
|
方法已順利完成。 |
|
ppszAddress 為 Null。 |
|
尚未設定傳輸位址。 若要設定傳輸位址,請使用非Null位址呼叫SetTransportAddress。 |
備註
這個方法所傳回的字串可能包含 IPv4 或未啟用的 IPv6 位址,例如 「fe80::1」。 它也可能包含包含埠的方括弧 IPv6 位址,例如 「[fe80::1]:1234」。 呼叫端應該仔細剖析字串,以考慮這兩種可能性。
規格需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wsdbase.h (包含 Wsdapi.h) |
Dll | Wsdapi.dll |