structure MPRAPI_ADMIN_DLL_CALLBACKS (mprapi.h)

Article
08/24/2023

La structure MPRAPI_ADMIN_DLL_CALLBACKS est utilisée par la fonction MprAdminInitializeDllEx pour inscrire les pointeurs de la fonction de rappel.

Syntaxe

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;

Membres

revision

Valeur qui représente la version de cette structure.

Valeur	Signification
MPRAPI_ADMIN_DLL_VERSION_1	La structure RAS_CONNECTION_EX et les pointeurs de fonction de rappel qui l’utilisent comme paramètre ne sont pas pris en charge par cette structure.
MPRAPI_ADMIN_DLL_VERSION_2	La structure RAS_CONNECTION_EX et les pointeurs de fonction de rappel qui l’utilisent comme paramètre sont pris en charge par cette structure.

lpfnMprAdminGetIpAddressForUser

Pointeur de fonction vers un instance du rappel MprAdminGetIpAddressForUser. Le prototype de rappel est défini comme suit :

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

lpfnMprAdminReleaseIpAddress

Pointeur de fonction vers un instance du rappel MprAdminReleaseIpAddress. Le prototype de rappel est défini comme suit :

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

lpfnMprAdminGetIpv6AddressForUser

Pointeur de fonction vers un instance du rappel MprAdminGetIpv6AddressForUser. Le prototype de rappel est défini comme suit :

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

lpfnMprAdminReleaseIpV6AddressForUser

Pointeur de fonction vers un instance du rappel MprAdminReleaseIpv6AddressForUser. Le prototype de rappel est défini comme suit :

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

lpfnRasAdminAcceptNewLink

Pointeur de fonction vers un instance du rappel MprAdminAcceptNewLink. Le prototype de rappel est défini comme suit :

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

lpfnRasAdminLinkHangupNotification

Pointeur de fonction vers un instance du rappel MprAdminLinkHangupNotification. Le prototype de rappel est défini comme suit :

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

lpfnRasAdminTerminateDll

Pointeur de fonction vers un instance du rappel MprAdminTerminateDll. Le prototype de rappel est défini comme suit :

typedef DWORD (APIENTRY * PMPRADMINTERMINATEDLL)();

lpfnRasAdminAcceptNewConnectionEx

Pointeur de fonction vers un instance du rappel MprAdminAcceptNewConnectionEx. Le prototype de rappel est défini comme suit :

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

lpfnRasAdminAcceptEndpointChangeEx

lpfnRasAdminAcceptReauthenticationEx

Pointeur de fonction vers un instance du rappel MprAdminAcceptReauthenticationEx. Le prototype de rappel est défini comme suit :

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

lpfnRasAdminConnectionHangupNotificationEx

Pointeur de fonction vers un instance du rappel MprAdminConnectionHangupNotificationEx. Le prototype de rappel est défini comme suit :

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

lpfnRASValidatePreAuthenticatedConnectionEx

Remarques

Les restrictions suivantes s’appliquent aux fonctions de rappel dans la structure MPRAPI_ADMIN_DLL_CALLBACKS :

LpfnMprAdminGetIpv6AddressForUser et lpfnMprAdminReleaseIpV6AddressForUser doivent être implémentés.
LpfnMprAdminGetIpAddressForUser et lpfnMprAdminReleaseIpAddress doivent être implémentés.
LpfnRasAdminLinkHangupNotification ou lpfnRasAdminAcceptNewLink doit être implémenté.
LpfnRasAdminAcceptNewConnectionEx ou lpfnRasAdminConnectionHangupNotificationEx doit être implémenté.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	mprapi.h