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

Статья
08/25/2023

[Эта функция недоступна в Windows Server 2008.

]

Функция RasCustomDial — это определяемая приложением функция, экспортируемая сторонней библиотекой DLL с пользовательским набором номера. Эта функция позволяет сторонним поставщикам реализовывать пользовательские процедуры набора номера для удаленного доступа.

Синтаксис

RasCustomDialFn Rascustomdialfn;

DWORD Rascustomdialfn(
  HINSTANCE hInstDll,
  LPRASDIALEXTENSIONS lpRasDialExtensions,
  LPCWSTR lpszPhonebook,
  LPRASDIALPARAMS lpRasDialParams,
  DWORD dwNotifierType,
  LPVOID lpvNotifier,
  LPHRASCONN lphRasConn,
  DWORD dwFlags
)
{...}

Параметры

hInstDll

Обработайте экземпляр загруженной библиотеки DLL пользовательского набора.

lpRasDialExtensions

Указатель на структуру RASDIALEXTENSIONS , которая указывает набор расширенных функций RasDial для включения. Присвойте этому параметру значение NULL , если нет необходимости включать расширения.

lpszPhonebook

Указатель на строку, завершающуюся null, которая указывает полный путь и имя файла телефонной книги (PBK). Если этот параметр имеет значение NULL, функция использует текущий файл телефонной книги по умолчанию. Файл телефонной книги по умолчанию — это файл, выбранный пользователем на странице свойств Пользовательские настройки диалогового окна Сеть с телефонным подключением .

lpRasDialParams

Указатель на структуру RASDIALPARAMS , указывающую параметры вызова для подключения RAS.

Вызывающий объект должен задать для члена dwSize структуры RASDIALPARAMS значение sizeof(RASDIALPARAMS), чтобы определить версию передаваемой структуры.

dwNotifierType

Этот параметр совпадает с параметром dwNotifierType для функции RasDial . Дополнительные сведения см. на странице справочника По RasDial .

lpvNotifier

Этот параметр совпадает с параметром lpvNotifier для функции RasDial . Дополнительные сведения см. на странице справочника По RasDial .

lphRasConn

Указатель на переменную типа HRASCONN. Перед вызовом RasDial задайте для переменной HRASCONNзначение NULL. Если RasDial завершается успешно, дескриптор подключения RAS сохраняется в *lphRasConn.

dwFlags

Этот параметр зарезервирован для использования в будущем.

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

Если функция выполняется успешно, возвращаемое значение ERROR_SUCCESS и возвращается дескриптор соединения RAS в переменной, на которую указывает параметр lphRasConn .

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

Значение	Значение
ERROR_NOT_ENOUGH_MEMORY	Функции не удалось выделить достаточный объем памяти для завершения операции.

Требования


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