mprapi.h) (MPRAPI_ADMIN_DLL_CALLBACKS 结构

项目
08/24/2023

MprAdminInitializeDllEx 函数使用 MPRAPI_ADMIN_DLL_CALLBACKS 结构来注册回调函数指针。

语法

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 回调实例的函数指针。回调原型定义为：

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

lpfnMprAdminReleaseIpAddress

指向 MprAdminReleaseIpAddress 回调实例的函数指针。回调原型定义为：

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

lpfnMprAdminGetIpv6AddressForUser

指向 MprAdminGetIpv6AddressForUser 回调实例的函数指针。回调原型定义为：

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

lpfnMprAdminReleaseIpV6AddressForUser

指向 MprAdminReleaseIpv6AddressForUser 回调实例的函数指针。回调原型定义为：

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

lpfnRasAdminAcceptNewLink

指向 MprAdminAcceptNewLink 回调实例的函数指针。回调原型定义为：

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

lpfnRasAdminLinkHangupNotification

指向 MprAdminLinkHangupNotification 回调实例的函数指针。回调原型定义为：

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

lpfnRasAdminTerminateDll

指向 MprAdminTerminateDll 回调实例的函数指针。回调原型定义为：

typedef DWORD (APIENTRY * PMPRADMINTERMINATEDLL)();

lpfnRasAdminAcceptNewConnectionEx

指向 MprAdminAcceptNewConnectionEx 回调实例的函数指针。回调原型定义为：

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

lpfnRasAdminAcceptEndpointChangeEx

lpfnRasAdminAcceptReauthenticationEx

指向 MprAdminAcceptReauthenticationEx 回调实例的函数指针。回调原型定义为：

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

lpfnRasAdminConnectionHangupNotificationEx

指向 MprAdminConnectionHangupNotificationEx 回调实例的函数指针。回调原型定义为：

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

lpfnRASValidatePreAuthenticatedConnectionEx

注解

以下限制适用于 MPRAPI_ADMIN_DLL_CALLBACKS 结构中的回调函数：

lpfnMprAdminGetIpv6AddressForUser 和 lpfnMprAdminReleaseIpV6AddressForUser 都必须实现，或者两者都不实现。
lpfnMprAdminGetIpAddressForUser 和 lpfnMprAdminReleaseIpAddress 都必须实现，或者两者都不实现。
必须实现 lpfnRasAdminLinkHangupNotification 或 lpfnRasAdminAcceptNewLink 。
必须实现 lpfnRasAdminAcceptNewConnectionEx 或 lpfnRasAdminConnectionHangupNotificationEx 。