RASADFUNCA 回调函数（ras.h）

项目
11/20/2024

RASADFunc 函数是一个应用程序定义的回调函数，用于提供自定义的用户界面进行自动诊断。

语法

RASADFUNCA Rasadfunca;

BOOL Rasadfunca(
  LPSTR unnamedParam1,
  LPSTR unnamedParam2,
  LPRASADPARAMS unnamedParam3,
  LPDWORD unnamedParam4
)
{...}

参数

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

返回值

如果应用程序执行拨号操作，则返回 true 。使用 lpdwRetCode 参数指示拨号操作的结果。

如果应用程序不执行拨号操作，则返回 FALSE。在这种情况下，系统使用默认用户界面进行拨号。

言论

当系统使用自定义自动处理程序启动电话簿条目的自动序列化操作时，它将调用指定的 RASADFunc。 RASADFunc 可以启动线程来执行自定义拨号操作。 RASADFunc 函数返回 true true，以指示它接管拨号，或 FALSE 以允许系统执行拨号。

如果 RASADFunc 函数执行拨号操作，它将提供自己的用户界面进行拨号，并调用 RasDial 函数来执行实际的拨号。然后，RASADFunc 返回 TRUE，以指示它接管了拨号。完成拨号操作后，将 lpdwRetCode 参数指向的变量设置为指示成功或失败。

AutoDial DLL 必须同时提供 RASADFUNCA （ANSI）和 RASADFUNCW （Unicode）版本的 RASADFunc 处理程序。若要为电话簿条目启用 RASADFunc 自动处理程序，请使用对 RasSetEntryProperties 函数的调用中的 RASENTRY 结构。 szAutodialDll 成员指定包含处理程序的 DLL 的名称，szAutodialFunc 成员指定处理程序的导出名称。 szAutodialFunc 成员不应包含“A”或“W”后缀。

RASADFunc 是库定义的函数名称的占位符。 RASADFUNC 类型是指向 RASADFunc 函数的指针。

注意

ras.h 标头将 RASADFUNC 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	ras.h