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

Статья
08/25/2023

Используйте функцию 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.

Значение	Значение
E_INVALIDARG	Параметр pdwSizeofEapData имеет значение NULL.
ERROR_BUFFER_TOO_SMALL	Буфер, на который указывает pbEapData , слишком мал для получения данных. PdwSizeofEapData содержит требуемый размер.
ERROR_CANNOT_OPEN_PHONEBOOK	RasGetEapUserData не удалось открыть указанный файл телефонной книги.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	RasGetEapUserData не удалось найти указанную запись в телефонной книге.
Другое	Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки.

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

Требования

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

См. также раздел

RASEAPINFO

RasSetEapUserData

Общие сведения о службе удаленного доступа (RAS)

Функции службы удаленного доступа

Share via