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