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 scope 지정하는 DRT_SCOPE 열거형입니다.

dwScopeId

scope 연결된 인터페이스를 고유하게 지정하는 식별자입니다.

전역 scope 경우 이 매개 변수는 항상 "GLOBAL_" ID이며 전역 scope 사용하는 경우 선택 사항입니다. 링크 로컬 scope 경우 이 매개 변수는 링크 로컬 scope 있는 네트워크 인터페이스 카드와 연결된 인터페이스를 나타냅니다.

dwLocalityThreshold

이웃을 캐싱할 때 IpV6 주소를 기반으로 하는 지역 정보 사용 방법을 지정하는 식별자입니다. 기본적으로 DRT는 로컬 컴퓨터와 공통 접두사를 가진 IPv6 주소가 있는 인접 항목에 대한 기본 설정을 제공합니다.

[in, out] pwPort

로컬 DRT instance 사용하는 포트에 대한 포인터입니다.

[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	지정된 scope DRT_GLOBAL_SCOPE, DRT_SITE_LOCAL_SCOPE 또는 DRT_LINK_LOCAL_SCOPE 아닙니다.
DRT_E_TRANSPORT_UNEXPECTED	예기치 않은 오류가 발생했습니다. 원인은 TraceError를 참조하세요.

 

참고 이 함수는 NotifyUnicastIpAddressChange, WSAStartup, GetAdaptersAddresses, setsockopt, WSASocket, Bind, WSAIoctl, CreateThreadpoolIo, CreateThreadpoolCleanupGroup 및 CreateTimerQueue에 대한 기본 호출에서 오류를 반환할 수도 있습니다.

 

설명

이 함수에서 만든 기본 IPv6 UDP 전송은 만든 DRT와 관련이 있습니다. 따라서 여러 DRT에서 다시 사용할 수 없습니다.

WINDOWS XP에서 SP2(서비스 팩 2)와 함께 분산 라우팅 테이블 API를 사용하는 경우 DrtCreateIpv6UdpTransport 를 사용하여 전송을 만들려면 IPv6 프로토콜 지원을 사용하도록 설정해야 합니다.

요구 사항

지원되는 최소 클라이언트	Windows 7 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	drt.h
라이브러리	Drttransport.lib
DLL	Drt.dll

추가 정보

DRT_SETTINGS

DrtDeleteIpv6UdpTransport