GetUdpTable 함수(iphlpapi.h)

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

구문

IPHLPAPI_DLL_LINKAGE ULONG GetUdpTable(
  [out]     PMIB_UDPTABLE UdpTable,
  [in, out] PULONG        SizePointer,
  [in]      BOOL          Order
);

[out] UdpTable

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

[in, out] SizePointer

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

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

Windows Vista 이상용으로 릴리스된 Windows SDK에서 이 매개 변수의 데이터 형식은 PDWORD와 동일한 PULONG으로 변경됩니다.

[in] Order

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

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

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

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

Windows Vista 이상용으로 릴리스된 Windows SDK에서 GetUdpTable 함수의 반환 값은 DWORD와 동일한 ULONG의 데이터 형식으로 변경됩니다.


지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	iphlpapi.h
라이브러리	Iphlpapi.lib
DLL	Iphlpapi.dll