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

Статья
11/20/2024

Используйте функцию RasSetEapUserData для хранения сведений о расширяемом протоколе проверки подлинности (EAP) для указанной записи телефонной книги в реестре.

Синтаксис

DWORD RasSetEapUserDataA(
  [in] HANDLE hToken,
  [in] LPCSTR pszPhonebook,
  [in] LPCSTR pszEntry,
  [in] BYTE   *pbEapData,
  [in] DWORD  dwSizeofEapData
);

Параметры

[in] hToken

Обработка первичного или олицетворения маркера доступа, представляющего пользователя, для которого хранятся данные. Этот параметр может быть null, если функция вызывается из процесса, уже запущенного в контексте пользователя.

[in] pszPhonebook

Указатель на строку null-terminated, которая указывает полный путь к файлу телефонной книги (PBK). Если этот параметр null, функция использует системную телефонную книгу.

[in] pszEntry

Указатель на строку null-terminated, указывающую существующее имя записи.

[in] pbEapData

Указатель на данные для хранения для пользователя.

[in] dwSizeofEapData

Указывает размер данных, на которые указывает параметр pbEapData.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение ERROR_SUCCESS.

Если функция завершается ошибкой, возвращаемое значение является одним из следующих кодов ошибок или значения из кодов ошибок маршрутизации и удаленного доступа или Winerror.h.

Ценность	Значение
E_INVALIDARG	Параметр dwSizeofEapData равен нулю, или параметр pbEapData равен NULL.
ERROR_CANNOT_OPEN_PHONEBOOK	RasSetEapUserData не удалось открыть указанный файл телефонной книги.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	RasSetEapUserData не удалось найти указанную запись в телефонной книге.
Другие	Используйте FormatMessage, чтобы получить системное сообщение об ошибке, соответствующее возвращенной коду ошибки.

Замечания

Заметка

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

Требования

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

См. также

RasGetEapUserData

RasInvokeEapUI

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

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

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