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

Статья
08/25/2023

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

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

Синтаксис

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

Параметры

[in] unnamedParam1

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

[in] unnamedParam2

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

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

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

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

Код возврата	Описание
ERROR_CANNOT_OPEN_PHONEBOOK	Телефонная книга повреждена или отсутствуют компоненты.

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

Требования


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