MprAdminInterfaceQueryUpdateResult 함수(mprapi.h)

아티클
02/29/2024

MprAdminInterfaceQueryUpdateResult 함수는 지정된 라우터 관리자에게 마지막 요청의 결과를 반환하여 인터페이스에 대한 경로를 업데이트합니다. 자세한 내용은 MprAdminInterfaceUpdateRoutes를 참조하세요.

구문

DWORD MprAdminInterfaceQueryUpdateResult(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwProtocolId,
  [out] LPDWORD           lpdwUpdateResult
);

매개 변수

[in] hMprServer

정보를 검색할 라우터에 대한 핸들입니다. MprAdminServerConnect를 호출하여 이 핸들을 가져옵니다.

[in] hInterface

인터페이스에 대한 핸들입니다. 이 핸들은 MprAdminInterfaceCreate에 대한 이전 호출에서 가져옵니다.

[in] dwProtocolId

쿼리할 라우터 관리자를 지정하는 DWORD 값입니다. 라우터는 각 전송 프로토콜에 대해 다른 라우터 관리자를 사용합니다. dwTransportId에 허용되는 값은 다음 표에 나와 있습니다.

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

[out] lpdwUpdateResult

DWORD 변수에 대한 포인터입니다. 이 변수는 MprAdminInterfaceUpdateRoutes에 대한 마지막 호출의 결과를 받습니다.

반환 값

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

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

값	의미
ERROR_ACCESS_DENIED	호출 애플리케이션에는 충분한 권한이 없습니다.
ERROR_INTERFACE_NOT_CONNECTED	지정된 인터페이스가 연결되어 있지 않습니다. 마지막 업데이트의 결과를 더 이상 사용할 수 없습니다.
ERROR_INVALID_HANDLE	hInterface 값이 잘못되었습니다.
ERROR_INVALID_PARAMETER	lpdwUpdateResult 매개 변수는 NULL입니다.
ERROR_NO_SUCH_INTERFACE	지정된 전송이 지정된 인터페이스에서 실행되고 있지 않습니다.
ERROR_UNKNOWN_PROTOCOL_ID	dwProtocolId 값이 지원되는 라우터 관리자와 일치하지 않습니다.

설명

dwProtocolId 매개 변수는 라우터가 각 전송에 대해 라우터 관리자를 유지 관리하므로 전송 및 라우터 관리자를 모두 지정합니다.

요구 사항

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