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

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

Синтаксис

RasCustomEntryDlgFn Rascustomentrydlgfn;

BOOL Rascustomentrydlgfn(
  HINSTANCE hInstDll,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPRASENTRYDLG lpInfo,
  DWORD dwFlags
)
{...}

Параметры

hInstDll

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

lpszPhonebook

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

lpszEntry

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

Если вы редактируете или копируете запись, этот параметр является именем существующей записи телефонной книги. При копировании записи установите флаг RASEDFLAG_CloneEntry в элементе dwFlags структуры RASENTRYDLG .

При создании записи этот параметр является новым именем записи по умолчанию, которое пользователь может изменить. Если этот параметр имеет значение NULL, функция предоставляет имя по умолчанию. Если вы создаете запись, установите флаг RASEDFLAG_NewEntry в элементе dwFlags структуры RASENTRYDLG .

lpInfo

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

dwFlags

Зарезервировано для последующего использования.

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

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

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

Комментарии

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

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

Требования

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

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

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

RASENTRY

RasCustomDial

RasCustomDialDlg

RasCustomHangUp

RasEntryDlg

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

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