Функция обратного вызова RasCustomScriptExecuteFn (ras.h)

Статья
08/25/2023

RAS вызывает функцию RasCustomScriptExecute при установке подключения для записи телефонной книги, для которого задан параметр RASEO_CustomScript .

Синтаксис

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

Указатель на строку Юникода, содержащую путь к телефонной книге, в которой находится запись для подключения.

[in] lpszEntryName

Указатель на строку Юникода, содержащую имя записи, набранной для установления соединения.

[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

Указатель на структуру RASDIALPARAMS в Юникоде . Эта структура содержит учетные данные проверки подлинности для пользователя. Библиотека DLL настраиваемого скрипта может изменять элементы szUserName, szPassword и szDomain этой структуры. Протокол PPP будет использовать все, что хранится в этих членах при возврате RasCustomScriptExecute .

pvReserved

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение должно быть ERROR_SUCCESS.

Если функция завершается ошибкой, возвращаемое значение должно быть соответствующим кодом ошибки из Winerror.h или Raserror.h.

В некоторых случаях szUserName структуры RASDIALPARAMS будет пустой строкой. В таких случаях библиотека DLL пользовательских сценариев должна использовать версию Юникода функции GetUserName для получения имени текущего пользователя.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	ras.h