структура MPRAPI_ADMIN_DLL_CALLBACKS (mprapi.h)

Статья
03/15/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 . Прототип обратного вызова определяется следующим образом:

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

Необходимо реализовать как lpfnMprAdminGetIpv6AddressForUser , так и lpfnMprAdminReleaseIpV6AddressForUser .
Необходимо реализовать как lpfnMprAdminGetIpAddressForUser , так и lpfnMprAdminReleaseIpAddress .
Необходимо реализовать lpfnRasAdminLinkHangupNotification или lpfnRasAdminAcceptNewLink .
Необходимо реализовать lpfnRasAdminAcceptNewConnectionEx или lpfnRasAdminConnectionHangupNotificationEx .

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Верхняя часть	mprapi.h