GetTcp6Table2 함수(iphlpapi.h)

아티클
08/24/2023

GetTcp6Table2 함수는 IPv6에 대한 TCP 연결 테이블을 검색합니다.

구문

IPHLPAPI_DLL_LINKAGE ULONG GetTcp6Table2(
  [out]     PMIB_TCP6TABLE2 TcpTable,
  [in, out] PULONG          SizePointer,
  [in]      BOOL            Order
);

매개 변수

[out] TcpTable

IPv6에 대한 TCP 연결 테이블을 MIB_TCP6TABLE2 구조로 수신하는 버퍼에 대한 포인터입니다.

[in, out] SizePointer

입력에서 는 TcpTable 매개 변수가 가리키는 버퍼의 크기를 지정합니다.

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

[in] Order

TCP 연결 테이블을 정렬할지 여부를 지정하는 값입니다. 이 매개 변수가 TRUE이면 테이블이 가장 낮은 로컬 IP 주소부터 오름차순으로 정렬됩니다. 이 매개 변수가 FALSE이면 테이블이 검색된 순서대로 표시됩니다.

다음 값은 TCP 엔드포인트를 정렬할 때(나열된 대로) 비교됩니다.

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

반환 값

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

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

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

설명

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

GetTcp6Table2 함수는 TCP 연결의 TCP 오프로드 상태에 대한 정보도 검색하는 향상된 버전의 GetTcp6Table 함수입니다.

요구 사항


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