Поделиться через


Функция RasEditPhonebookEntryA (ras.h)

[Эта функция не рекомендуется использовать в Windows Vista, а ее функциональность заменена на RasEntryDlg.]

Функция RasEditPhonebookEntry редактирует существующую запись телефонной книги. Функция отображает диалоговое окно, в котором пользователь может изменить существующую информацию.

Синтаксис

DWORD RasEditPhonebookEntryA(
  [in] HWND   unnamedParam1,
  [in] LPCSTR unnamedParam2,
  [in] LPCSTR unnamedParam3
);

Параметры

[in] unnamedParam1

Дескриптор родительского окна диалогового окна.

[in] unnamedParam2

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

[in] unnamedParam3

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

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

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

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

Код возврата Описание
ERROR_BUFFER_INVALID
Недопустимый буфер ввода телефонной книги.
ERROR_CANNOT_OPEN_PHONEBOOK
Телефонная книга повреждена или отсутствуют компоненты.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY
Запись телефонной книги не существует.

Комментарии

При вызове RasEntryDlg задайте для каждого члена структуры RASENTRYDLG , передаваемой в lpinfo , значение 0, за исключением следующих:

  • dwSize = sizeof(RASENTRYDLG)
  • hwndOwner = параметр hwnd выше

Примечание

Заголовок ras.h определяет RasEditPhonebookEntry в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

RasCreatePhonebookEntry

RasEntryDlg

RasGetEntryDialParams

RasSetEntryDialParams

Общие сведения о службе удаленного доступа (RAS)

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