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

  • Статья

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

]

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

Синтаксис

RasCustomDialDlgFn Rascustomdialdlgfn;

BOOL Rascustomdialdlgfn(
  HINSTANCE hInstDll,
  DWORD dwFlags,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPWSTR lpszPhoneNumber,
  LPRASDIALDLG lpInfo,
  PVOID pvInfo
)
{...}

Параметры

hInstDll

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

dwFlags

Набор битовых флагов, указывающих параметры RasCustomDialDlg .

Значение Значение
RCD_Logon
 Если для этого флага задано значение one, подключение было набрано из контекста входа в Windows. RasDial использует эти сведения для получения соответствующих пользовательских настроек для записи подключения. Если RasDial вызывается из этой точки входа, член dwfOptions параметра lpRasDialExtension должен иметь флаг RDEOPT_NoUser , указывающий, что соединение было набрано из контекста входа в Windows.
 

Windows Server 2003 и Windows XP/2000: Этот параметр зарезервирован и не должен использоваться.

lpszPhonebook

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

lpszEntry

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

lpszPhoneNumber

Указатель на строку, завершающуюся значением NULL, которая содержит номер телефона, который переопределяет номера, хранящиеся в записи телефонной книги. Если этот параметр имеет значение NULL, RasDialDlg использует номера в записи телефонной книги.

lpInfo

Указатель на структуру RASDIALDLG , содержащую дополнительные входные и выходные параметры. Во входных данных член dwSize этой структуры должен указывать sizeof( RASDIALDLG). При возникновении ошибки член dwError возвращает код ошибки; В противном случае возвращается ноль.

pvInfo

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

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

Если пользователь создает, копирует или изменяет запись телефонной книги, возвращается значение TRUE. В противном случае функция должна возвращать значение FALSE.

Если возникает ошибка, RasCustomEntryDlg должен задать члену dwError структуры RASENTRYDLG значение из кода ошибок маршрутизации и удаленного доступа или Winerror.h.

Комментарии

RAS вызывает эту точку входа из RasDialDlg, если член szCustomDialDll структуры RASENTRY для набираемой записи указывает настраиваемую библиотеку DLL.

Если эта точка входа вызывает RasDial, параметр lpRasDialExtensions не должен иметь значение NULL, а член dwfOptions структуры RASDIALEXTENSIONS должен иметь флаг RDEOPT_CustomDial .

Диалоговое окно настраиваемого набора должно поддерживать WM_COMMAND сообщений, где ЗНАЧЕНИЕ LOWORD(wParam) равно IDCANCEL.

Если библиотека DLL с пользовательским набором не поддерживает эту точку входа, RAS возвращает ERROR_CANNOT_DO_CUSTOMDIAL вызывающей библиотеке RasDialDlg.

Требования

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

См. также раздел

Пользовательские набиратели номера

RASENTRY

RasCustomDial

RasCustomEntryDlg

RasCustomHangUp

RasDialDlg

Обзор службы удаленного доступа (RAS)

Функции службы удаленного доступа