estrutura MPRAPI_ADMIN_DLL_CALLBACKS (mprapi.h)

Artigo
03/15/2023

A estrutura MPRAPI_ADMIN_DLL_CALLBACKS é usada pela função MprAdminInitializeDllEx para registrar os ponteiros da função de retorno de chamada.

Sintaxe

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;

Membros

revision

Um valor que representa a versão dessa estrutura.

Valor	Significado
MPRAPI_ADMIN_DLL_VERSION_1	Não há suporte para a estrutura RAS_CONNECTION_EX e os ponteiros da função de retorno de chamada que a usam como parâmetro.
MPRAPI_ADMIN_DLL_VERSION_2	A estrutura RAS_CONNECTION_EX e os ponteiros da função de retorno de chamada que a usam como parâmetro são compatíveis com essa estrutura.

lpfnMprAdminGetIpAddressForUser

Um ponteiro de função para uma instância do retorno de chamada MprAdminGetIpAddressForUser . O protótipo de retorno de chamada é definido como:

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

lpfnMprAdminReleaseIpAddress

Um ponteiro de função para uma instância do retorno de chamada MprAdminReleaseIpAddress . O protótipo de retorno de chamada é definido como:

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

lpfnMprAdminGetIpv6AddressForUser

Um ponteiro de função para uma instância do retorno de chamada MprAdminGetIpv6AddressForUser . O protótipo de retorno de chamada é definido como:

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

lpfnMprAdminReleaseIpV6AddressForUser

Um ponteiro de função para uma instância do retorno de chamada MprAdminReleaseIpv6AddressForUser . O protótipo de retorno de chamada é definido como:

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

lpfnRasAdminAcceptNewLink

Um ponteiro de função para uma instância do retorno de chamada MprAdminAcceptNewLink . O protótipo de retorno de chamada é definido como:

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

lpfnRasAdminLinkHangupNotification

Um ponteiro de função para uma instância do retorno de chamada MprAdminLinkHangupNotification . O protótipo de retorno de chamada é definido como:

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

lpfnRasAdminTerminateDll

Um ponteiro de função para uma instância do retorno de chamada MprAdminTerminateDll . O protótipo de retorno de chamada é definido como:

typedef DWORD (APIENTRY * PMPRADMINTERMINATEDLL)();

lpfnRasAdminAcceptNewConnectionEx

Um ponteiro de função para uma instância do retorno de chamada MprAdminAcceptNewConnectionEx . O protótipo de retorno de chamada é definido como:

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

lpfnRasAdminAcceptEndpointChangeEx

lpfnRasAdminAcceptReauthenticationEx

Um ponteiro de função para uma instância do retorno de chamada MprAdminAcceptReauthenticationEx . O protótipo de retorno de chamada é definido como:

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

lpfnRasAdminConnectionHangupNotificationEx

Um ponteiro de função para uma instância do retorno de chamada MprAdminConnectionHangupNotificationEx . O protótipo de retorno de chamada é definido como:

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

lpfnRASValidatePreAuthenticatedConnectionEx

Comentários

As seguintes restrições se aplicam às funções de retorno de chamada na estrutura MPRAPI_ADMIN_DLL_CALLBACKS :

LpfnMprAdminGetIpv6AddressForUser e lpfnMprAdminReleaseIpV6AddressForUser devem ser implementados ou nenhum deles é implementado.
LpfnMprAdminGetIpAddressForUser e lpfnMprAdminReleaseIpAddress devem ser implementados ou nenhum deles é implementado.
LpfnRasAdminLinkHangupNotification ou lpfnRasAdminAcceptNewLink devem ser implementados.
LpfnRasAdminAcceptNewConnectionEx ou lpfnRasAdminConnectionHangupNotificationEx devem ser implementados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho	mprapi.h