MPRAPI_ADMIN_DLL_CALLBACKS結構 (mprapi.h)

發行項
02/29/2024

MprAdminInitializeDllEx 函式會使用MPRAPI_ADMIN_DLL_CALLBACKS結構來註冊回呼函式指標。

語法

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

備註

下列限制適用於 MPRAPI_ADMIN_DLL_CALLBACKS 結構中的回呼函式：

lpfnMprAdminGetIpv6AddressForUser 和 lpfnMprAdminReleaseIpV6AddressForUser 都必須實作，或未實作兩者。
lpfnMprAdminGetIpAddressForUser 和 lpfnMprAdminReleaseIpAddress 都必須實作，或兩者都未實作。
必須實作 lpfnRasAdminLinkHangupNotification 或 lpfnRasAdminAcceptNewLink 。
必須實作 lpfnRasAdminAcceptNewConnectionEx 或 lpfnRasAdminConnectionHangupNotificationEx 。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限傳統型應用程式]
標頭	mprapi.h