Client-Side 構成ユーザー インターフェイス
認証プロトコルを実装するベンダーは、プロトコルの構成ユーザー インターフェイス (UI) を提供することもできます。 構成 UI は、認証プロトコルと同じ DLL または別の DLL に実装できます。 また、構成 UI を実装する DLL では、複数の認証プロトコルがサポートされている場合があります。 構成 UI の DLL へのパスは、認証プロトコルのキーの下にあるRAS_EAP_VALUENAME_CONFIGUIレジストリ値に格納されます。 このレジストリ値の作成の詳細については、「 EAP のインストール」を参照してください。
構成ユーザー インターフェイスの DLL は、次の関数のエントリ ポイントをエクスポートする必要があります。
RAS またはワイヤレス クライアントのどちらに対しても、ユーザーが特定の接続の構成エントリを作成すると、ユーザーはサービスがそのエントリで使用する必要がある認証プロトコルを選択できます。 認証プロトコルが構成可能な場合、サービスは RasEapInvokeConfigUI を呼び出して構成 UI を呼び出します。 構成 UI は、 RasEapInvokeConfigUI によって返される構成情報を構成エントリに格納します。
構成情報は、クライアント コンピューター上のすべてのユーザーに対して汎用的である必要があります。 特定のユーザーまたはユーザーに固有の情報をエントリに格納しないでください。 認証プロトコルでは、 ID 関数 または 対話型ユーザー インターフェイスを使用して、ユーザー固有の情報を取得する必要があります。 認証プロトコルは、RasEapMakeMessage の pEapOutput パラメーターで認証サービスに渡すことによって、この情報をレジストリに格納できます。
構成情報は、現在のコンピューターに固有のものではありません。それは機械から機械への携帯用であるべきである。
認証サービスは、認証プロトコルの RasEapBegin 関数を呼び出すと、構成情報へのポインターを含む PPP_EAP_INPUT 構造体を渡します。 RasEapBegin の呼び出しが完了すると、認証サービスは RasEapFreeMemory を呼び出して、構成情報によって占有されているメモリを解放します。 そのため、認証プロトコルでは、 RasEapBegin の呼び出し中に、構成情報をプライベート メモリ バッファーにコピーする必要があります。
ベンダーは、認証プロトコルのレジストリ キーの下に、プロトコルの既定の構成情報を指定する値を追加できます。 ベンダーは、電話帳エントリを作成するときに、ユーザーが構成情報を入力する必要があるかどうかを指定する値を追加することもできます。 詳細については、「 認証プロトコル レジストリ値」を参照してください。