LookupPersistentUdpPortReservation 함수(iphlpapi.h)

아티클
08/24/2023

LookupPersistentUdpPortReservation 함수는 로컬 컴퓨터에서 연속된 TCP 포트 블록에 대한 영구 UDP 포트 예약에 대한 토큰을 조회합니다.

구문

IPHLPAPI_DLL_LINKAGE ULONG LookupPersistentUdpPortReservation(
  [in]  USHORT   StartPort,
  [in]  USHORT   NumberOfPorts,
  [out] PULONG64 Token
);

매개 변수

[in] StartPort

네트워크 바이트 순서의 시작 UDP 포트 번호입니다.

[in] NumberOfPorts

예약된 UDP 포트 번호의 수입니다.

[out] Token

함수가 성공하면 반환되는 포트 예약 토큰에 대한 포인터입니다.

반환 값

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

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

반환 코드	설명
ERROR_INVALID_PARAMETER	잘못된 매개 변수가 함수에 전달되었습니다. StartPort 또는NumberOfPorts 매개 변수에 0이 전달되면 이 오류가 반환됩니다.
ERROR_NOT_FOUND	요소를 찾을 수 없습니다. StartPort 및 NumberOfPorts 매개 변수로 지정된 영구 포트 블록을 찾을 수 없는 경우 이 오류가 반환됩니다.
기타	FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

설명

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

LookupPersistentUdpPortReservation 함수는 UDP 포트 블록에 대한 영구 예약에 대한 토큰을 조회하는 데 사용됩니다.

UDP 포트 블록에 대한 영구 예약은 CreatePersistentUdpPortReservation 함수를 호출하여 만듭니다. LookupPersistentUdpPortReservation 함수에 전달된 StartPort 또는 NumberOfPorts 매개 변수는 CreatePersistentUdpPortReservation 함수에서 TCP 포트 블록에 대한 영구 예약을 만들 때 사용되는 값과 일치해야 합니다.

LookupPersistentUdpPortReservation 함수가 성공하면 반환된 토큰 매개 변수는 UDP 포트 블록에 대한 영구 포트 예약에 대한 토큰을 가리킵니다. 시스템이 다시 시작될 때마다 TCP 포트 블록에 대해 지정된 영구 예약에 대한 토큰이 변경될 수 있습니다.

애플리케이션은 UDP 소켓을 연 다음 WSAIoctl 함수를 호출하여 UDP 포트 예약에서 포트 할당을 요청할 수 있으며, SIO_ASSOCIATE_PORT_RESERVATION IOCTL을 지정하고 예약 토큰을 전달한 후 소켓의 바인딩 함수에 대한 호출을 실행합니다.

요구 사항

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