MPRAPI_ADMIN_DLL_CALLBACKS-Struktur (mprapi.h)

Artikel
02/29/2024

Die MPRAPI_ADMIN_DLL_CALLBACKS-Struktur wird von der MprAdminInitializeDllEx-Funktion verwendet, um die Rückruffunktionszeiger zu registrieren.

Syntax

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;

Member

revision

Ein Wert, der die Version dieser Struktur darstellt.

Wert	Bedeutung
MPRAPI_ADMIN_DLL_VERSION_1	Die RAS_CONNECTION_EX-Struktur und die Rückruffunktionszeiger, die sie als Parameter verwenden, werden von dieser Struktur nicht unterstützt.
MPRAPI_ADMIN_DLL_VERSION_2	Die RAS_CONNECTION_EX-Struktur und die Rückruffunktionszeiger, die sie als Parameter verwenden, werden von dieser Struktur unterstützt.

lpfnMprAdminGetIpAddressForUser

Ein Funktionszeiger auf eine instance des MprAdminGetIpAddressForUser-Rückrufs. Der Rückrufprototyp ist definiert wie folgt:

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

lpfnMprAdminReleaseIpAddress

Ein Funktionszeiger auf eine instance des MprAdminReleaseIpAddress-Rückrufs. Der Rückrufprototyp ist definiert wie folgt:

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

lpfnMprAdminGetIpv6AddressForUser

Ein Funktionszeiger auf eine instance des MprAdminGetIpv6AddressForUser-Rückrufs. Der Rückrufprototyp ist definiert wie folgt:

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

lpfnMprAdminReleaseIpV6AddressForUser

Ein Funktionszeiger auf eine instance des MprAdminReleaseIpv6AddressForUser-Rückrufs. Der Rückrufprototyp ist definiert wie folgt:

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

lpfnRasAdminAcceptNewLink

Ein Funktionszeiger auf eine instance des MprAdminAcceptNewLink-Rückrufs. Der Rückrufprototyp ist definiert wie folgt:

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

lpfnRasAdminLinkHangupNotification

Ein Funktionszeiger auf eine instance des MprAdminLinkHangupNotification-Rückrufs. Der Rückrufprototyp ist definiert wie folgt:

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

lpfnRasAdminTerminateDll

Ein Funktionszeiger auf eine instance des MprAdminTerminateDll-Rückrufs. Der Rückrufprototyp ist definiert wie folgt:

typedef DWORD (APIENTRY * PMPRADMINTERMINATEDLL)();

lpfnRasAdminAcceptNewConnectionEx

Ein Funktionszeiger auf eine instance des MprAdminAcceptNewConnectionEx-Rückrufs. Der Rückrufprototyp ist definiert wie folgt:

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

lpfnRasAdminAcceptEndpointChangeEx

lpfnRasAdminAcceptReauthenticationEx

Ein Funktionszeiger auf eine instance des MprAdminAcceptReauthenticationEx-Rückrufs. Der Rückrufprototyp ist definiert wie folgt:

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

lpfnRasAdminConnectionHangupNotificationEx

Ein Funktionszeiger auf eine instance des MprAdminConnectionHangupNotificationEx-Rückrufs. Der Rückrufprototyp ist definiert wie folgt:

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

lpfnRASValidatePreAuthenticatedConnectionEx

Hinweise

Die folgenden Einschränkungen gelten für die Rückruffunktionen in der MPRAPI_ADMIN_DLL_CALLBACKS-Struktur :

Sowohl lpfnMprAdminGetIpv6AddressForUser als auch lpfnMprAdminReleaseIpV6AddressForUser müssen implementiert werden, sonst werden keine implementiert.
Sowohl lpfnMprAdminGetIpAddressForUser als auch lpfnMprAdminReleaseIpAddress müssen implementiert werden, sonst werden beide implementiert.
Entweder lpfnRasAdminLinkHangupNotification oder lpfnRasAdminAcceptNewLink muss implementiert werden.
Entweder lpfnRasAdminAcceptNewConnectionEx oder lpfnRasAdminConnectionHangupNotificationEx muss implementiert werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile	mprapi.h