Функция RasSetEapUserDataA (ras.h)
Используйте функцию RasSetEapUserData для хранения сведений о пользовательском протоколе EAP для указанной записи телефонной книги в реестре.
Синтаксис
DWORD RasSetEapUserDataA(
[in] HANDLE hToken,
[in] LPCSTR pszPhonebook,
[in] LPCSTR pszEntry,
[in] BYTE *pbEapData,
[in] DWORD dwSizeofEapData
);
Параметры
[in] hToken
Обработка до основного маркера доступа или маркера олицетворения, представляющего пользователя, для которого будут храниться данные. Этот параметр может иметь значение NULL , если функция вызывается из процесса, уже запущенного в контексте пользователя.
[in] pszPhonebook
Указатель на строку с пустым завершением, указывающую полный путь к файлу телефонной книги (PBK). Если этот параметр имеет значение NULL, функция использует системную телефонную книгу.
[in] pszEntry
Указатель на строку, завершающуюся значением NULL, которая указывает существующее имя записи.
[in] pbEapData
Указатель на данные для хранения для пользователя.
[in] dwSizeofEapData
Задает размер данных, на которые указывает параметр pbEapData .
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается ошибкой, возвращается один из следующих кодов ошибок или значение из кода ошибок маршрутизации и удаленного доступа или Winerror.h.
Значение | Значение |
---|---|
|
Параметр dwSizeofEapData равен нулю или параметр pbEapData имеет значение NULL. |
|
RasSetEapUserData не удалось открыть указанный файл телефонной книги. |
|
RasSetEapUserData не удалось найти указанную запись в телефонной книге. |
|
Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки. |
Комментарии
Примечание
Заголовок ras.h определяет RasSetEapUserData в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | ras.h |
Библиотека | Rasapi32.lib |
DLL | Rasapi32.dll |