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

Статья
11/20/2024

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

Синтаксис

DWORD RasSetCustomAuthDataA(
  [in] LPCSTR pszPhonebook,
  [in] LPCSTR pszEntry,
  [in] BYTE   *pbCustomAuthData,
  [in] DWORD  dwSizeofCustomAuthData
);

Параметры

[in] pszPhonebook

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

[in] pszEntry

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

[in] pbCustomAuthData

Указатель на буфер, указывающий новые данные проверки подлинности.

[in] dwSizeofCustomAuthData

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

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

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

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

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

Замечания

Заметка

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

Требования

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

См. также

RasGetCustomAuthData

RasSetEapUserData

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