MPRAPI_ADMIN_DLL_CALLBACKS 構造体 (mprapi.h)

[アーティクル]
03/15/2023

MPRAPI_ADMIN_DLL_CALLBACKS構造体は、コールバック関数ポインターを登録するために MprAdminInitializeDllEx 関数によって使用されます。

構文

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 [デスクトップアプリのみ]
Header	mprapi.h