RasEapInvokeConfigUI-Funktion (raseapif.h)

Artikel
08/25/2023

Der RAS-Verbindungs-Manager ruft die RasEapInvokeConfigUI-Funktion auf, um ein Dialogfeld zum Abrufen von Konfigurationsinformationen vom Benutzer anzuzeigen. RAS ruft RasEapInvokeConfigUI auf, wenn ein neuer Telefonbucheintrag erstellt oder ein vorhandener Telefonbucheintrag bearbeitet wird, sofern das Authentifizierungsprotokoll für den Eintrag eine Konfigurationsbenutzeroberfläche bereitstellt.

Syntax

DWORD RasEapInvokeConfigUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  DWORD dwFlags,
  [in]  BYTE  *pConnectionDataIn,
  [in]  DWORD dwSizeOfConnectionDataIn,
  [out] BYTE  **ppConnectionDataOut,
  [out] DWORD *pdwSizeOfConnectionDataOut
);

Parameter

[in] dwEapTypeId

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

[in] hwndParent

Handle bis zum übergeordneten Fenster für das Dialogfeld der Benutzeroberfläche.

[in] dwFlags

Gibt null oder mehr der folgenden Flags an, die den Authentifizierungsprozess qualifizieren.

Flag	Bedeutung
RAS_EAP_FLAG_ROUTER	Gibt an, dass der Einwahlcomputer ein Router ist. Das Fehlen dieses Flags gibt an, dass der Einwahlcomputer ein RAS-Client ist.
RAS_EAP_FLAG_8021X_AUTH	Gibt an, dass diese Sitzung in einem drahtlosen Kontext ausgeführt wird.
RAS_EAP_FLAG_GUEST_ACCESS	Gibt an, wenn der Client Gastzugriff wünscht. Dieses Flag wird normalerweise im Fall einer Drahtlosen Verbindung verwendet, sodass der drahtlose Client, sofern er für die Anforderung des Gastzugriffs konfiguriert ist, dieses Flag übergibt, wenn die Authentifizierung für die Anzahl aufeinanderfolgender Versuche fehlschlägt. Der RADIUS-Server sollte so eingerichtet werden, dass der Gastzugriff zugelassen wird.

[in] pConnectionDataIn

Zeiger auf die derzeit im Telefonbucheintrag gespeicherten Verbindungsdaten. Wenn der Telefonbucheintrag keine Daten enthält, ist dieser Parameter NULL.

[in] dwSizeOfConnectionDataIn

Gibt die Größe der derzeit im Telefonbucheintrag gespeicherten Verbindungsdaten an. Wenn der Telefonbucheintrag für diese Verbindung keine Daten enthält, ist dieser Parameter null.

[out] ppConnectionDataOut

Zeiger auf einen Zeiger, der bei erfolgreicher Rückgabe auf die neuen Verbindungsdaten verweist, die im Telefonbucheintrag gespeichert werden sollen. Keine dieser Daten sollte für den aktuellen Computer spezifisch sein. Telefonbucheinträge sollten von Computer zu Computer portierbar sein.

[out] pdwSizeOfConnectionDataOut

Zeiger auf ein DWORD , das die Größe der neuen Verbindungsdaten empfängt, die im Telefonbucheintrag gespeichert werden sollen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion nicht in der Lage war, Arbeitsspeicher für die Konfigurationsdaten 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 RasEapInvokeConfigUI und RasEapFreeMemory implementiert, unterstützt möglicherweise mehr als ein Authentifizierungsprotokoll. Der dwEapTypeId-Parameter gibt an, für welches Protokoll die Konfigurationsbenutzeroberfläche aufgerufen werden soll.

RAS speichert die von RasEapInvokeConfigUI zurückgegebenen Verbindungsdaten im Telefonbucheintrag für die Verbindung auf dem Clientcomputer.

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