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

Статья
11/20/2024

Используйте функцию 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	Параметр pdwSizeofEapDataNULL.
ERROR_BUFFER_TOO_SMALL	Буфер, на который указывает pbEapData, слишком мал, чтобы получить данные. pdwSizeofEapData содержит требуемый размер.
ERROR_CANNOT_OPEN_PHONEBOOK	RasGetEapUserData не удалось открыть указанный файл телефонной книги.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	RasGetEapUserData не удалось найти указанную запись в телефонной книге.
Другие	Используйте FormatMessage, чтобы получить системное сообщение об ошибке, соответствующее возвращенной коду ошибки.

Замечания

Заметка

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

Требования

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

См. также

RASEAPINFO

RasSetEapUserData

Обзор службы удаленного доступа (RAS)

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

Поделиться через