GetTeredoPort 함수
GetTeredoPort 함수는 Teredo 클라이언트가 로컬 컴퓨터에서 사용하는 동적 UDP 포트 번호를 검색합니다.
구문
NETIOAPI_API GetTeredoPort(
_Out_ USHORT *Port
);
매개 변수
- 포트 [out]
UDP 포트 번호에 대한 포인터입니다. 반환이 성공하면 이 매개 변수는 Teredo 클라이언트에서 사용하는 포트 번호로 채워집니다.
반환 값
GetTeredoPort 는 함수가 성공하면 STATUS_SUCCESS 반환합니다.
함수가 실패 하면 GetTeredoPort 는 다음 오류 코드 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_INVALID_PARAMETER | 잘못된 매개 변수가 함수에 전달되었습니다. 포트 매개 변수에 NULL 포인터가 전달되면 이 오류가 반환됩니다. |
| ERROR_NOT_READY | 디바이스가 준비되지 않았습니다. Teredo 클라이언트가 로컬 컴퓨터에서 시작되지 않은 경우 이 오류가 반환됩니다. |
| STATUS_NOT_SUPPORTED | 요청이 지원되지 않습니다. 이 오류는 로컬 컴퓨터에 IPv6 스택이 없는 경우 반환됩니다. |
| 기타 | FormatMessage 함수를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다. |
설명
GetTeredoPort 함수는 Teredo 클라이언트가 Teredo 서비스 포트에 사용하는 현재 UDP 포트 번호를 검색합니다. Teredo 포트는 동적이며 로컬 컴퓨터에서 Teredo 클라이언트가 다시 시작될 때마다 변경할 수 있습니다. 드라이버는 NotifyTeredoPortChange 함수를 호출하여 Teredo 서비스 포트가 변경될 때 알림을 받도록 등록할 수 있습니다.
또한 Teredo 클라이언트는 RFC 4380에 정의된 대로 멀티캐스트 IPv4 주소 224.0.0.253에서 전송되는 멀티캐스트 트래픽을 수신 대기하는 데 정적 UDP 포트 3544를 사용합니다. 자세한 내용은 Teredo: UDPthrough NAT(네트워크 주소 변환)를 통해 IPv6 터널링을 참조하세요.
GetTeredoPort 함수는 수신 및 나가는 Teredo 트래픽을 사용하도록 적절한 예외를 구성하기 위해 주로 방화벽 드라이버에서 사용됩니다.
요구 사항
대상 플랫폼 |
보편적인 |
버전 |
Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
헤더 |
Netioapi.h(Netioapi.h 포함) |
라이브러리 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |