MPRAPI_ADMIN_DLL_CALLBACKS struttura (mprapi.h)

Articolo
03/15/2023

La struttura MPRAPI_ADMIN_DLL_CALLBACKS viene usata dalla funzione MprAdminInitializeDllEx per registrare i puntatori delle funzioni di callback.

Sintassi

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;

Members

revision

Valore che rappresenta la versione di questa struttura.

Valore	Significato
MPRAPI_ADMIN_DLL_VERSION_1	La struttura RAS_CONNECTION_EX e i puntatori di funzione callback che lo usano come parametro non sono supportati da questa struttura.
MPRAPI_ADMIN_DLL_VERSION_2	La struttura RAS_CONNECTION_EX e i puntatori di funzione callback che lo usano come parametro sono supportati da questa struttura.

lpfnMprAdminGetIpAddressForUser

Puntatore di funzione a un'istanza del callback MprAdminGetIpAddressForUser . Il prototipo di callback è definito come:

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

lpfnMprAdminReleaseIpAddress

Puntatore di funzione a un'istanza del callback MprAdminReleaseIpAddress . Il prototipo di callback è definito come:

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

lpfnMprAdminGetIpv6AddressForUser

Puntatore di funzione a un'istanza del callback MprAdminGetIpv6AddressForUser . Il prototipo di callback è definito come:

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

lpfnMprAdminReleaseIpV6AddressForUser

Puntatore di funzione a un'istanza del callback MprAdminReleaseIpv6AddressForUser . Il prototipo di callback è definito come:

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

lpfnRasAdminAcceptNewLink

Puntatore di funzione a un'istanza del callback MprAdminAcceptNewLink . Il prototipo di callback è definito come:

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

lpfnRasAdminLinkHangupNotification

Puntatore di funzione a un'istanza del callback MprAdminLinkHangupNotification . Il prototipo di callback è definito come:

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

lpfnRasAdminTerminateDll

Puntatore di funzione a un'istanza del callback MprAdminTerminateDll . Il prototipo di callback è definito come:

typedef DWORD (APIENTRY * PMPRADMINTERMINATEDLL)();

lpfnRasAdminAcceptNewConnectionEx

Puntatore di funzione a un'istanza del callback MprAdminAcceptNewConnectionEx . Il prototipo di callback è definito come:

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

lpfnRasAdminAcceptEndpointChangeEx

lpfnRasAdminAcceptReauthenticationEx

Puntatore di funzione a un'istanza del callback MprAdminAcceptReauthenticationEx . Il prototipo di callback è definito come:

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

lpfnRasAdminConnectionHangupNotificationEx

Puntatore di funzione a un'istanza del callback MprAdminConnectionHangupNotificationEx . Il prototipo di callback è definito come:

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

lpfnRASValidatePreAuthenticatedConnectionEx

Commenti

Le restrizioni seguenti si applicano alle funzioni di callback nella struttura di MPRAPI_ADMIN_DLL_CALLBACKS :

Entrambi lpfnMprAdminGetIpv6AddressForUser e lpfnMprAdminReleaseIpV6AddressForUser devono essere implementati o non vengono implementati nessuno dei due.
Sia lpfnMprAdminGetIpAddressForUser che lpfnMprAdminReleaseIpAddress devono essere implementati o non vengono implementati nessuno dei due.
È necessario implementare lpfnRasAdminLinkHangupNotification o lpfnRasAdminAcceptNewLink .
È necessario implementare lpfnRasAdminAcceptNewConnectionEx o lpfnRasAdminConnectionHangupNotificationEx .