Пользовательский интерфейс конфигурации Client-Side

Поставщик, реализующий протокол проверки подлинности, также может предоставить пользовательский интерфейс конфигурации для протокола. Пользовательский интерфейс конфигурации может быть реализован в той же библиотеке DLL, что и протокол проверки подлинности, или в отдельной библиотеке DLL. Кроме того, библиотека DLL, реализующая пользовательский интерфейс конфигурации, может поддерживать несколько протоколов проверки подлинности. Путь к библиотеке DLL для пользовательского интерфейса конфигурации хранится в значении реестра RAS_EAP_VALUENAME_CONFIGUI в разделе ключа протокола проверки подлинности. Дополнительные сведения о создании этого значения реестра см. в установке EAP.

Библиотека DLL для пользовательского интерфейса конфигурации должна экспортировать точки входа для следующих функций:

RasEapInvokeConfigUI

RasEapFreeMemory

Когда пользователь создает запись конфигурации для определенного подключения, независимо от того, используется ли клиент RAS или беспроводной сети, пользователь может выбрать протокол проверки подлинности, который служба должна использовать с этой записью. Если протокол проверки подлинности настраивается, служба вызывает RasEapInvokeConfigUI для вызова пользовательского интерфейса конфигурации. Пользовательский интерфейс конфигурации хранит сведения о конфигурации, возвращаемые RasEapInvokeConfigUI в записи конфигурации.

Сведения о конфигурации должны быть универсальными для всех пользователей на клиентском компьютере. Сведения, относящиеся к конкретному пользователю или пользователям, не должны храниться в записи. Протокол проверки подлинности должен получить сведения, относящиеся к пользователю, с помощью функций идентификации или интерактивногопользовательского интерфейса. Протокол проверки подлинности может хранить эти сведения в реестре, передав его службе проверки подлинности в параметре pEapOutputRasEapMakeMessage.

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

Когда служба проверки подлинности вызывает функцию RasEapBegin для протокола проверки подлинности, она передает структуру PPP_EAP_INPUT, содержащую указатель на сведения о конфигурации. После завершения вызова RasEapBegin служба проверки подлинности вызывает RasEapFreeMemory, чтобы освободить память, занятую сведениями о конфигурации. Поэтому протокол проверки подлинности должен скопировать сведения о конфигурации в частный буфер памяти во время вызова RasEapBegin.

Поставщик может добавить значение в разделе реестра для протокола проверки подлинности, указывающего сведения о конфигурации по умолчанию для протокола. Поставщик также может добавить значение, указывающее, требуется ли пользователю вводить сведения о конфигурации при создании записи телефонной книги. Дополнительные сведения см. в разделе Значения реестра протоколов проверки подлинности.