RasEapInvokeInteractiveUI-Funktion (raseapif.h)

Artikel
08/25/2023

Der RAS-Verbindungs-Manager ruft die RasEapInvokeInteractiveUI-Funktion auf, um ein Dialogfeld zum Abrufen von Authentifizierungsdaten vom Benutzer anzuzeigen.

Syntax

DWORD RasEapInvokeInteractiveUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  BYTE  *pUIContextData,
  [in]  DWORD dwSizeOfUIContextData,
        BYTE  **ppDataFromInteractiveUI,
  [out] DWORD *pdwSizeOfDataFromInteractiveUI
);

Parameter

[in] dwEapTypeId

Gibt das Authentifizierungsprotokoll an, für das die interaktive Benutzeroberfläche aufgerufen werden soll.

[in] hwndParent

Handle zum übergeordneten Fenster für das Dialogfeld.

[in] pUIContextData

Zeiger auf Kontextdaten für die interaktive Benutzeroberfläche. Das Authentifizierungsprotokoll stellt einen Zeiger auf diese Daten als Mitglied der PPP_EAP_OUTPUT-Struktur bereit. Die RAS-Verbindungs-Manager empfängt die PPP_EAP_OUTPUT-Struktur als Ausgabeparameter von der RasEapMakeMessage-Funktion.

[in] dwSizeOfUIContextData

Gibt die Größe der Kontextdaten an. Das Authentifizierungsprotokoll stellt die Größe als Mitglied der PPP_EAP_OUTPUT-Struktur bereit. Die RAS-Verbindungs-Manager empfängt die PPP_EAP_OUTPUT-Struktur als Ausgabeparameter von der RasEapMakeMessage-Funktion.

ppDataFromInteractiveUI

[out[ Zeiger auf eine Zeigervariable. Bei erfolgreicher Rückgabe zeigt diese Zeigervariable auf einen Speicherpuffer, der die von der interaktiven Benutzeroberfläche abgerufenen Daten enthält. Die interaktive Benutzeroberfläche weist diesen Arbeitsspeicher zu. RAS übergibt diese Daten zurück an das Authentifizierungsprotokoll in der PPP_EAP_INPUT-Struktur . Ras gibt diesen Arbeitsspeicher dann durch Aufrufen von RasEapFreeMemory frei.

Wenn die interaktive Benutzeroberfläche keine benutzerspezifischen Daten abruft, sollte der Zeiger, auf den ppUserData verweist, auf NULL festgelegt werden.

[out] pdwSizeOfDataFromInteractiveUI

Zeiger auf eine DWORD-Variable , die die Größe der von der interaktiven Benutzeroberfläche zurückgegebenen Daten empfängt. Wenn die interaktive Benutzeroberfläche keine benutzerspezifischen Daten abruft, sollte die DWORD-Variable auf Null festgelegt werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR. Überprüfen Sie die Parameter ppDataFromInteractiveUI und lpdwSizeOfDataFromInteractiveUI , um zu ermitteln, ob die Funktion Daten von der interaktiven Benutzeroberfläche zurückgegeben hat.

Wenn die Funktion nicht in der Lage war, Arbeitsspeicher für die Daten zuzuweisen, sollte der Rückgabewert ERROR_NOT_ENOUGH_MEMORY werden.

Wenn die Funktion auf andere Weise fehlschlägt, sollte der Rückgabewert ein geeigneter Fehlercode von Winerror.h, Raserror.h oder Mprerror.h sein.

Hinweise

Die DLL, die die Funktionen RasEapInvokeInteractiveUI und RasEapFreeMemory implementiert, unterstützt möglicherweise mehr als ein Authentifizierungsprotokoll. Der dwEapTypeId-Parameter gibt das Authentifizierungsprotokoll an, für das die interaktive Benutzeroberfläche aufgerufen werden soll.

Ein Zeiger auf die von der interaktiven Benutzeroberfläche zurückgegebenen Daten wird an das Authentifizierungsprotokoll im pDataFromInteractiveUI-Element der PPP_EAP_INPUT-Struktur zurückgegeben. Die PPP_EAP_INPUT-Struktur wird als Parameter an die RasEapMakeMessage-Funktion übergeben.

Die interaktive Benutzeroberfläche muss WM_COMMAND Nachrichten unterstützen, wobei LOWORD(wParam) IDCANCEL entspricht.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	raseapif.h