MPRAPI_ADMIN_DLL_CALLBACKS 구조체(mprapi.h)

아티클
08/24/2023

MPRAPI_ADMIN_DLL_CALLBACKS 구조체는 MprAdminInitializeDllEx 함수에서 콜백 함수 포인터를 등록하는 데 사용됩니다.

구문

typedef struct _MPRAPI_ADMIN_DLL_CALLBACKS {
  UCHAR                                            revision;
  PMPRADMINGETIPADDRESSFORUSER                     lpfnMprAdminGetIpAddressForUser;
  PMPRADMINRELEASEIPADRESS                         lpfnMprAdminReleaseIpAddress;
  PMPRADMINGETIPV6ADDRESSFORUSER                   lpfnMprAdminGetIpv6AddressForUser;
  PMPRADMINRELEASEIPV6ADDRESSFORUSER               lpfnMprAdminReleaseIpV6AddressForUser;
  PMPRADMINACCEPTNEWLINK                           lpfnRasAdminAcceptNewLink;
  PMPRADMINLINKHANGUPNOTIFICATION                  lpfnRasAdminLinkHangupNotification;
  PMPRADMINTERMINATEDLL                            lpfnRasAdminTerminateDll;
  PMPRADMINACCEPTNEWCONNECTIONEX                   lpfnRasAdminAcceptNewConnectionEx;
  PMPRADMINACCEPTTUNNELENDPOINTCHANGEEX            lpfnRasAdminAcceptEndpointChangeEx;
  PMPRADMINACCEPTREAUTHENTICATIONEX                lpfnRasAdminAcceptReauthenticationEx;
  PMPRADMINCONNECTIONHANGUPNOTIFICATIONEX          lpfnRasAdminConnectionHangupNotificationEx;
  PMPRADMINRASVALIDATEPREAUTHENTICATEDCONNECTIONEX lpfnRASValidatePreAuthenticatedConnectionEx;
} MPRAPI_ADMIN_DLL_CALLBACKS, *PMPRAPI_ADMIN_DLL_CALLBACKS;

멤버

revision

이 구조체의 버전을 나타내는 값입니다.

값	의미
MPRAPI_ADMIN_DLL_VERSION_1	RAS_CONNECTION_EX 구조체와 이를 매개 변수로 사용하는 콜백 함수 포인터는 이 구조체에서 지원되지 않습니다.
MPRAPI_ADMIN_DLL_VERSION_2	RAS_CONNECTION_EX 구조체와 이를 매개 변수로 사용하는 콜백 함수 포인터는 이 구조체에서 지원됩니다.

lpfnMprAdminGetIpAddressForUser

MprAdminGetIpAddressForUser 콜백의 instance 대한 함수 포인터입니다. 콜백 프로토타입은 다음과 같이 정의됩니다.

typedef DWORD (APIENTRY * PMPRADMINGETIPADDRESSFORUSER)(WCHAR *, WCHAR *, DWORD *, BOOL *);

lpfnMprAdminReleaseIpAddress

MprAdminReleaseIpAddress 콜백의 instance 대한 함수 포인터입니다. 콜백 프로토타입은 다음과 같이 정의됩니다.

typedef VOID  (APIENTRY * PMPRADMINRELEASEIPADRESS)(WCHAR *, WCHAR *, DWORD *);

lpfnMprAdminGetIpv6AddressForUser

MprAdminGetIpv6AddressForUser 콜백의 instance 대한 함수 포인터입니다. 콜백 프로토타입은 다음과 같이 정의됩니다.

typedef DWORD (APIENTRY * PMPRADMINGETIPV6ADDRESSFORUSER)(WCHAR *, WCHAR *, IN6_ADDR *, BOOL *);

lpfnMprAdminReleaseIpV6AddressForUser

MprAdminReleaseIpv6AddressForUser 콜백의 instance 대한 함수 포인터입니다. 콜백 프로토타입은 다음과 같이 정의됩니다.

typedef VOID  (APIENTRY * PMPRADMINRELEASEIPV6ADDRESSFORUSER)(WCHAR *, WCHAR *, IN6_ADDR *);

lpfnRasAdminAcceptNewLink

MprAdminAcceptNewLink 콜백의 instance 대한 함수 포인터입니다. 콜백 프로토타입은 다음과 같이 정의됩니다.

typedef BOOL  (APIENTRY * PMPRADMINACCEPTNEWLINK)(RAS_PORT_0 *, RAS_PORT_1 *);

lpfnRasAdminLinkHangupNotification

MprAdminLinkHangupNotification 콜백의 instance 대한 함수 포인터입니다. 콜백 프로토타입은 다음과 같이 정의됩니다.

typedef VOID  (APIENTRY * PMPRADMINLINKHANGUPNOTIFICATION)(RAS_PORT_0 *, RAS_PORT_1 *);

lpfnRasAdminTerminateDll

MprAdminTerminateDll 콜백의 instance 대한 함수 포인터입니다. 콜백 프로토타입은 다음과 같이 정의됩니다.

typedef DWORD (APIENTRY * PMPRADMINTERMINATEDLL)();

lpfnRasAdminAcceptNewConnectionEx

MprAdminAcceptNewConnectionEx 콜백의 instance 대한 함수 포인터입니다. 콜백 프로토타입은 다음과 같이 정의됩니다.

typedef BOOL  (APIENTRY * PMPRADMINACCEPTNEWCONNECTIONEX)(RAS_CONNECTION_EX *);

lpfnRasAdminAcceptEndpointChangeEx

lpfnRasAdminAcceptReauthenticationEx

MprAdminAcceptReauthenticationEx 콜백의 instance 대한 함수 포인터입니다. 콜백 프로토타입은 다음과 같이 정의됩니다.

typedef BOOL  (APIENTRY * PMPRADMINACCEPTREAUTHENTICATIONEX)(RAS_CONNECTION_EX *);

lpfnRasAdminConnectionHangupNotificationEx

MprAdminConnectionHangupNotificationEx 콜백의 instance 대한 함수 포인터입니다. 콜백 프로토타입은 다음과 같이 정의됩니다.

typedef VOID  (APIENTRY * PMPRADMINCONNECTIONHANGUPNOTIFICATIONEX)(RAS_CONNECTION_EX *);

lpfnRASValidatePreAuthenticatedConnectionEx

설명

MPRAPI_ADMIN_DLL_CALLBACKS 구조의 콜백 함수에는 다음과 같은 제한이 적용됩니다.

lpfnMprAdminGetIpv6AddressForUser 및 lpfnMprAdminReleaseIpV6AddressForUser를 모두 구현해야 하거나 둘 다 구현되지 않습니다.
lpfnMprAdminGetIpAddressForUser 및 lpfnMprAdminReleaseIpAddress를 모두 구현해야 하며 둘 다 구현되지 않습니다.
lpfnRasAdminLinkHangupNotification 또는 lpfnRasAdminAcceptNewLink를 구현해야 합니다.
lpfnRasAdminAcceptNewConnectionEx 또는 lpfnRasAdminConnectionHangupNotificationEx를 구현해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
머리글	mprapi.h