GetUdp6Table 함수(iphlpapi.h)

아티클
03/05/2024

GetUdp6Table 함수는 IPv6 UDP(사용자 데이터그램 프로토콜) 수신기 테이블을 검색합니다.

구문

IPHLPAPI_DLL_LINKAGE ULONG GetUdp6Table(
  [out]     PMIB_UDP6TABLE Udp6Table,
  [in, out] PULONG         SizePointer,
  [in]      BOOL           Order
);

매개 변수

[out] Udp6Table

IPv6 UDP 수신기 테이블을 MIB_UDP6TABLE 구조로 수신하는 버퍼에 대한 포인터입니다.

[in, out] SizePointer

입력에서 는 Udp6Table 매개 변수가 가리키는 버퍼의 크기(바이트)를 지정합니다.

출력에서 버퍼가 반환된 수신기 테이블을 보유할 만큼 충분히 크지 않은 경우 함수는 이 매개 변수를 필요한 버퍼 크기(바이트)와 동일하게 설정합니다.

[in] Order

반환된 UDP 수신기 테이블을 정렬할지 여부를 지정하는 부울 값입니다. 이 매개 변수가 TRUE이면 테이블이 다음 순서로 정렬됩니다.

로컬 IPv6 주소
로컬 scope ID
로컬 포트

반환 값

함수가 성공하면 반환 값이 NO_ERROR.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

반환 코드	설명
ERROR_INSUFFICIENT_BUFFER	Udp6Table 매개 변수가 가리키는 버퍼가 충분히 크지 않습니다. 필요한 크기는 SizePointer 매개 변수가 가리키는 ULONG 변수에 반환됩니다.
ERROR_INVALID_PARAMETER	SizePointer 매개 변수가 NULL이거나 GetUdp6Table이 SizePointer 매개 변수가 가리키는 메모리에 쓸 수 없습니다.
ERROR_NOT_SUPPORTED	이 함수는 로컬 시스템에서 사용 중인 운영 체제에서 지원되지 않습니다.
기타	FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

설명

GetUdp6Table 함수는 Windows Vista 이상에서 정의됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	iphlpapi.h
라이브러리	Iphlpapi.lib
DLL	Iphlpapi.dll