estructura MPRAPI_ADMIN_DLL_CALLBACKS (mprapi.h)

Artículo
03/15/2023

La función MprAdminInitializeDllEx usa la estructura MPRAPI_ADMIN_DLL_CALLBACKS para registrar los punteros de función de devolución de llamada.

Sintaxis

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;

Miembros

revision

Valor que representa la versión de esta estructura.

Valor	Significado
MPRAPI_ADMIN_DLL_VERSION_1	La estructura RAS_CONNECTION_EX y los punteros de función de devolución de llamada que lo usan como parámetro no son compatibles con esta estructura.
MPRAPI_ADMIN_DLL_VERSION_2	Esta estructura admite la estructura RAS_CONNECTION_EX y los punteros de función de devolución de llamada que lo usan como parámetro.

lpfnMprAdminGetIpAddressForUser

Puntero de función a una instancia de la devolución de llamada MprAdminGetIpAddressForUser . El prototipo de devolución de llamada se define como:

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

lpfnMprAdminReleaseIpAddress

Puntero de función a una instancia de la devolución de llamada MprAdminReleaseIpAddress . El prototipo de devolución de llamada se define como:

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

lpfnMprAdminGetIpv6AddressForUser

Puntero de función a una instancia de la devolución de llamada MprAdminGetIpv6AddressForUser . El prototipo de devolución de llamada se define como:

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

lpfnMprAdminReleaseIpV6AddressForUser

Puntero de función a una instancia de la devolución de llamada MprAdminReleaseIpv6AddressForUser . El prototipo de devolución de llamada se define como:

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

lpfnRasAdminAcceptNewLink

Puntero de función a una instancia de la devolución de llamada MprAdminAcceptNewLink . El prototipo de devolución de llamada se define como:

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

lpfnRasAdminLinkHangupNotification

Puntero de función a una instancia de la devolución de llamada MprAdminLinkHangupNotification . El prototipo de devolución de llamada se define como:

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

lpfnRasAdminTerminateDll

Puntero de función a una instancia de la devolución de llamada MprAdminTerminateDll . El prototipo de devolución de llamada se define como:

typedef DWORD (APIENTRY * PMPRADMINTERMINATEDLL)();

lpfnRasAdminAcceptNewConnectionEx

Puntero de función a una instancia de la devolución de llamada MprAdminAcceptNewConnectionEx . El prototipo de devolución de llamada se define como:

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

lpfnRasAdminAcceptEndpointChangeEx

lpfnRasAdminAcceptReauthenticationEx

Puntero de función a una instancia de la devolución de llamada MprAdminAcceptReauthenticationEx . El prototipo de devolución de llamada se define como:

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

lpfnRasAdminConnectionHangupNotificationEx

Puntero de función a una instancia de la devolución de llamada MprAdminConnectionHangupNotificationEx . El prototipo de devolución de llamada se define como:

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

lpfnRASValidatePreAuthenticatedConnectionEx

Comentarios

Las restricciones siguientes se aplican a las funciones de devolución de llamada de la estructura MPRAPI_ADMIN_DLL_CALLBACKS :

Tanto lpfnMprAdminGetIpv6AddressForUser como lpfnMprAdminReleaseIpV6AddressForUser deben implementarse o ninguno de ellos.
Tanto lpfnMprAdminGetIpAddressForUser como lpfnMprAdminReleaseIpAddress deben implementarse o no se implementan.
Debe implementarse lpfnRasAdminLinkHangupNotification o lpfnRasAdminAcceptNewLink .
Se deben implementar lpfnRasAdminAcceptNewConnectionEx o lpfnRasAdminConnectionHangupNotificationEx .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado	mprapi.h