MprConfigInterfaceTransportGetHandle 함수(mprapi.h)

아티클
02/29/2024

MprConfigInterfaceTransportGetHandle 함수는 지정된 라우터 구성에서 인터페이스의 전송 구성에 대한 핸들을 검색합니다.

구문

DWORD MprConfigInterfaceTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  HANDLE hRouterInterface,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterIfTransport
);

매개 변수

[in] hMprConfig

라우터 구성에 대한 핸들입니다. MprConfigServerConnect를 호출하여 이 핸들을 가져옵니다.

[in] hRouterInterface

인터페이스 구성에 대한 핸들입니다. MprConfigInterfaceCreate, MprConfigInterfaceGetHandle 또는 MprConfigInterfaceEnum을 호출하여 이 핸들을 가져옵니다.

[in] dwTransportId

phRouterIfTransport 매개 변수의 전송 구성 핸들 형식을 설명하는 DWORD 값입니다. dwTransportId에 허용되는 값은 다음 표에 나와 있습니다.

값	전송(프로토콜 패밀리)
PID_ATALK	Appletalk
PID_IP	인터넷 프로토콜 버전 4
PID_IPX	인터넷 패킷 교환
PID_NBF	NetBIOS 프레임 프로토콜
PID_IPV6	Windows Server 2008 이상: 인터넷 프로토콜 버전 6

[out] phRouterIfTransport

에 대한 포인터입니다.
dwTransportId 매개 변수에 표시된 이 인터페이스의 전송 구성 핸들 형식을 수신하는 HANDLE 변수입니다.

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	다음 중 적어도 하나가 참입니다. hMprConfig 는 NULL입니다. hRouterInterface 는 NULL입니다. phRouterIfTransport 는 NULL입니다.
ERROR_NOT_ENOUGH_MEMORY	작업을 완료할 리소스가 부족합니다.
ERROR_NO_SUCH_INTERFACE	hRouterInterface로 지정된 인터페이스가 라우터 구성에서 찾을 수 없거나 dwTransportId로 지정된 전송이 지정된 인터페이스에서 사용하도록 설정되지 않았습니다.
기타	FormatMessage를 사용하여 반환된 오류 코드에 해당하는 시스템 오류 메시지를 검색합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	mprapi.h
라이브러리	Mprapi.lib
DLL	Mprapi.dll