Share via

DrtCreateIpv6UdpTransport 函式 (drt.h)

  • 發行項

DrtCreateIpv6UdpTransport函式會根據 IPv6 UDP 通訊協定建立傳輸。

語法

HRESULT DrtCreateIpv6UdpTransport(
            DRT_SCOPE      scope,
            ULONG          dwScopeId,
            ULONG          dwLocalityThreshold,
  [in, out] USHORT         *pwPort,
  [out]     HDRT_TRANSPORT *phTransport
);

參數

scope

指定 DRT 運作所在 IPv6 範圍的 DRT_SCOPE 列舉。

dwScopeId

唯一指定範圍相關聯之介面的識別碼。

針對全域範圍，此參數一律是 「GLOBAL_」 識別碼，而且在使用全域範圍時是選擇性的。 針對連結本機範圍，此參數代表與連結本機範圍存在之網路介面卡相關聯的介面。

dwLocalityThreshold

識別碼，指定快取鄰近專案時，如何根據 IpV6 位址使用位置資訊。 根據預設，DRT 會將喜好設定為具有本機電腦通用前置詞的 IPv6 位址的鄰近。

[in, out] pwPort

本機 DRT 實例所使用的埠指標。

[out] phTransport

DRT_SETTINGS結構中指定的 DRT 傳輸控制碼指標。

傳回值

此函式會在成功時傳回S_OK。 其他可能的值包括：

傳回碼 描述
E_OUTOFMEMORY
 系統無法為提供者配置記憶體。
DRT_E_INVALID_PORT
 pwPort 為 Null。
DRT_E_INVALID_TRANSPORT_PROVIDER
 hTransport 為 Null。
DRT_E_INVALID_SCOPE
 指定的範圍不是DRT_GLOBAL_SCOPE、DRT_SITE_LOCAL_SCOPE或DRT_LINK_LOCAL_SCOPE。
DRT_E_TRANSPORT_UNEXPECTED
 已發生未預期的錯誤。 如需原因，請參閱 TraceError。
 
注意此函式也可能從基礎呼叫NotifyUnicastIpAddressChange、WSAStartup、GetAdaptersAddresses、setockopt、WSASocket、Bind、WSAIoctl、CreateThreadpoolIo、CreateThreadpoolCleanupGroup和CreateTimerQueue傳回錯誤。
 

備註

此函式所建立的預設 IPv6 UDP 傳輸專屬於其建立的 DRT。 因此，無法在多個 DRT 之間重複使用。

在 Windows XP 中使用分散式路由表 API 搭配 Service Pack 2 (SP2) 時，必須啟用 IPv6 通訊協定的支援，才能使用 DrtCreateIpv6UdpTransport 建立傳輸成功。

需求

   
最低支援的用戶端 Windows 7 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 drt.h
程式庫 Drttransport.lib
Dll Drt.dll

另請參閱

DRT_SETTINGS

DrtDeleteIpv6UdpTransport