Функция RasCreatePhonebookEntryA (ras.h)
[Эта функция не рекомендуется использовать в Windows Vista, и ее функциональность была заменена RasDialDlg. ]
Функция RasCreatePhonebookEntry создает новую запись телефонной книги. Функция отображает диалоговое окно, в котором пользователь вводит сведения для записи телефонной книги.
Синтаксис
DWORD RasCreatePhonebookEntryA(
[in] HWND unnamedParam1,
[in] LPCSTR unnamedParam2
);
Параметры
[in] unnamedParam1
Дескриптор в родительском окне диалогового окна.
[in] unnamedParam2
Указатель на строку, завершающуюся null, которая указывает полный путь и имя файла телефонной книги (PBK). Если этот параметр имеет значение NULL, функция использует текущий файл телефонной книги по умолчанию. Файл телефонной книги по умолчанию — это файл, выбранный пользователем на странице свойств Пользовательские настройки диалогового окна Сеть с телефонным подключением .
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается ошибкой, возвращается один из следующих кодов ошибок или значение из кода ошибок маршрутизации и удаленного доступа или Winerror.h.
Код возврата | Описание |
---|---|
|
Телефонная книга повреждена или отсутствуют компоненты. |
Комментарии
При вызове RasDialDlg установите для каждого члена структуры RASDIALDLG , передаваемой в lpInfo , равный нулю, за исключением:
- dwSize = sizeof(RASDIALDLG)
- hwndOwner = параметр hwnd выше
- Dwflags = RASEDFLAG_NewEntry
Примечание
Заголовок ras.h определяет RasCreatePhonebookEntry как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | ras.h |
Библиотека | Rasapi32.lib |
DLL | Rasapi32.dll |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по