Функция 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.
| Код возврата | Описание |
|---|---|
|
Недопустимый буфер ввода телефонной книги. |
|
Телефонная книга повреждена или отсутствуют компоненты. |
|
Запись телефонной книги не существует. |
Комментарии
При вызове 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 |