RasCustomScriptExecuteFn 回调函数 (ras.h)

项目
08/25/2023

RAS 在为设置了 RASEO_CustomScript 选项的电话簿条目建立连接时调用 RasCustomScriptExecute 函数。

语法

RasCustomScriptExecuteFn Rascustomscriptexecutefn;

DWORD Rascustomscriptexecutefn(
  [in] HANDLE hPort,
  [in] LPCWSTR lpszPhonebook,
  [in] LPCWSTR lpszEntryName,
  [in] PFNRASGETBUFFER pfnRasGetBuffer,
  [in] PFNRASFREEBUFFER pfnRasFreeBuffer,
  [in] PFNRASSENDBUFFER pfnRasSendBuffer,
  [in] PFNRASRECEIVEBUFFER pfnRasReceiveBuffer,
  [in] PFNRASRETRIEVEBUFFER pfnRasRetrieveBuffer,
  [in] HWND hWnd,
  [in] RASDIALPARAMS *pRasDialParams,
       PVOID pvReserved
)
{...}

参数

[in] hPort

建立连接的端口的句柄。在端口上发送或接收数据时使用此句柄。

[in] lpszPhonebook

指向 Unicode 字符串的指针，该字符串包含连接条目所在的电话簿的路径。

[in] lpszEntryName

指向 Unicode 字符串的指针，该字符串包含为建立连接而拨打的条目的名称。

[in] pfnRasGetBuffer

指向 PFNRASGETBUFFER 类型的函数的指针。自定义脚本 DLL 应使用此函数分配内存以将数据发送到服务器。

[in] pfnRasFreeBuffer

指向 PFNRASFREEBUFFER 类型的函数的指针。自定义脚本 DLL 应使用此函数来释放 pfnRasGetBuffer 函数分配的内存。

[in] pfnRasSendBuffer

指向 PFNRASSENDBUFFER 类型的函数的指针。自定义脚本 DLL 使用此函数通过指定的端口与服务器通信。

[in] pfnRasReceiveBuffer

指向 PFNRASRECEIVEBUFFER 类型的函数的指针。自定义脚本 DLL 使用此函数通过指定的端口与服务器通信。

[in] pfnRasRetrieveBuffer

指向 PFNRASRETRIEVEBUFFER 类型的函数的指针。自定义脚本 DLL 使用此函数通过指定的端口与服务器通信。

[in] hWnd

自定义脚本 DLL 可用于向用户呈现用户界面的窗口的句柄。

[in] pRasDialParams

指向 Unicode RASDIALPARAMS 结构的指针。此结构包含用户的身份验证凭据。自定义脚本 DLL 可以修改此结构的 szUserName、 szPassword 和 szDomain 成员。当 RasCustomScriptExecute 返回时，点到点协议 (PPP) 将使用这些成员中存储的任何内容。

pvReserved

返回值

如果函数成功，则返回值应 ERROR_SUCCESS。

如果函数失败，则返回值应该是 Winerror.h 或 Raserror.h 中的相应错误代码。

注解

当 RAS 调用 RasCustomScriptExecute 时， pRasDialParams 参数将指向 Unicode RASDIALPARAMS 结构。也就是说，结构仅包含 Unicode 字符串。

在某些情况下，RASDIALPARAMS 结构的 szUserName 将是空字符串。在这些情况下，自定义脚本 DLL 应使用 GetUserName 函数的 Unicode 版本来获取当前用户的名称。

要求

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