RasSetEapUserDataA-Funktion (ras.h)
Verwenden Sie die RasSetEapUserData-Funktion , um benutzerspezifische EAP-Informationen (Extensible Authentication Protocol) für den angegebenen Telefonbucheintrag in der Registrierung zu speichern.
Syntax
DWORD RasSetEapUserDataA(
[in] HANDLE hToken,
[in] LPCSTR pszPhonebook,
[in] LPCSTR pszEntry,
[in] BYTE *pbEapData,
[in] DWORD dwSizeofEapData
);
Parameter
[in] hToken
Behandeln Eines primären Zugriffstokens oder Identitätswechsels, das den Benutzer darstellt, für den Daten gespeichert werden sollen. Dieser Parameter kann NULL sein, wenn die Funktion von einem Prozess aufgerufen wird, der bereits im Kontext des Benutzers ausgeführt wird.
[in] pszPhonebook
Zeiger auf eine NULL-beendete Zeichenfolge, die den vollständigen Pfad der PBK-Datei (Telefonbuchdatei) angibt. Wenn dieser Parameter NULL ist, verwendet die Funktion das Systemtelefonbuch.
[in] pszEntry
Zeiger auf eine NULL-Zeichenfolge, die einen vorhandenen Eintragsnamen angibt.
[in] pbEapData
Zeiger auf die Daten, die für den Benutzer gespeichert werden sollen.
[in] dwSizeofEapData
Gibt die Größe der Daten an, auf die der parameter pbEapData verweist.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes oder ein Wert aus Routing- und RAS-Fehlercodes oder Winerror.h.
Wert | Bedeutung |
---|---|
|
Der dwSizeofEapData-Parameter ist 0, oder der pbEapData-Parameter ist NULL. |
|
RasSetEapUserData konnte die angegebene Telefonbuchdatei nicht öffnen. |
|
RasSetEapUserData konnte den angegebenen Eintrag im Telefonbuch nicht finden. |
|
Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht. |
Hinweise
Hinweis
Der ras.h-Header definiert RasSetEapUserData als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | ras.h |
Bibliothek | Rasapi32.lib |
DLL | Rasapi32.dll |