RasSecurityDialogEnd 函数 (rasshost.h)

RasSecurityDialogEnd 函数是 RAS 服务器调用以终止身份验证事务的第三方 RAS 安全 DLL 入口点。

语法

DWORD RasSecurityDialogEnd(
  [in] HPORT hPort
);

参数

[in] hPort

指定 RAS 服务器在此身份验证事务的 RasSecurityDialogBegin 调用中传递给安全 DLL 的端口句柄。

返回值

如果安全 DLL 返回 NO_ERROR，则 RAS 服务器不会终止身份验证事务。 在这种情况下，安全 DLL 在准备好终止时，必须稍后调用 RasSecurityDialogComplete 函数。

如果安全 DLL 返回非零错误代码，则 RAS 服务器将终止身份验证事务。 在这种情况下，安全 DLL 不需要进行另一个 RasSecurityDialogComplete 调用。 返回 Winerror.h 或 Raserror.h 中定义的错误代码，例如 ERROR_PORT_DISCONNECTED。

注解

当安全 DLL 完成对远程用户的身份验证后，它将调用 RasSecurityDialogComplete 函数。 然后，RAS 服务器执行清理序列，其中包括对 DLL 的 RasSecurityDialogEnd 函数的调用。 这为安全 DLL 提供了执行任何必要清理的机会。 若要终止身份验证事务， RasSecurityDialogEnd 必须返回非零错误代码。

如果 RAS 服务器需要在安全 DLL 调用 RasSecurityDialogComplete 之前异常终止身份验证事务，则 RAS 服务器也可以调用 RasSecurityDialogEnd。 在这种情况下，安全 DLL 应终止与 hPort 端口句柄关联的工作线程，并执行任何其他必要的清理。 如果 RasSecurityDialogEnd 返回非零值，则安全 DLL 不需要调用 RasSecurityDialogComplete。

对于正常终止和异常终止， RasSecurityDialogEnd 函数返回NO_ERROR来延迟终止。 如果这样做，则必须稍后在准备好终止时调用 RasSecurityDialogComplete 。

要求

另请参阅

RAS 服务器管理功能

RasSecurityDialogBegin

RasSecurityDialogComplete

远程访问服务 (RAS) 概述