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

Статья
11/20/2024

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

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

Синтаксис

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

Параметры

[in] unnamedParam1

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

[in] unnamedParam2

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

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

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

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

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

Замечания

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

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

Заметка

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

Требования

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