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

Статья
11/20/2024

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

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

Синтаксис

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

Параметры

[in] unnamedParam1

Обработка родительского окна диалогового окна.

[in] unnamedParam2

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

[in] unnamedParam3

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

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

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

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

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

Замечания

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

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	ras.h
библиотеки	Rasapi32.lib
DLL	Rasapi32.dll