RasSetEntryDialParamsA-Funktion (ras.h)
Die RasSetEntryDialParams-Funktion ändert die Verbindungsinformationen, die beim letzten erfolgreichen Aufruf gespeichert wurden, an die Funktion RasDial oder RasSetEntryDialParams für einen angegebenen Telefonbucheintrag.
Syntax
DWORD RasSetEntryDialParamsA(
[in] LPCSTR unnamedParam1,
[in] LPRASDIALPARAMSA unnamedParam2,
[in] BOOL unnamedParam3
);
Parameter
[in] unnamedParam1
Zeiger auf eine NULL-endende Zeichenfolge, die den vollständigen Pfad und Dateinamen einer Telefonbuchdatei (PBK) angibt. Wenn dieser Parameter NULL ist, verwendet die Funktion die aktuelle Standardtelefonbuchdatei. Die Standardmäßige Telefonbuchdatei wird vom Benutzer im Eigenschaftenblatt Benutzereinstellungen des DialogfeldsDFÜ-Netzwerk ausgewählt.
Windows Me/98/95: Dieser Parameter sollte immer NULL sein. Einwahlnetzwerk speichert Telefonbucheinträge in der Registrierung und nicht in einer Telefonbuchdatei.
[in] unnamedParam2
Zeiger auf die RASDIALPARAMS-Struktur , die die Verbindungsparameter angibt, die dem Telefonbucheintrag zugeordnet werden sollen. RasSetEntryDialParams verwendet die Member der -Struktur wie folgt.
Mitglied | Bedeutung |
---|---|
|
Muss die Größe von (RASDIALPARAMS) angeben, um die Version der Struktur zu identifizieren. |
|
Eine NULL-endende Zeichenfolge, die den Telefonbucheintrag identifiziert, für den Parameter festgelegt werden sollen. |
|
Wird nicht verwendet. Auf NULL festgelegt. |
|
Eine NULL-endende Zeichenfolge, die die Rückruftelefonnummer enthält. Wenn szCallbackNumber eine leere Zeichenfolge ist ( ""), wird die Rückrufnummer nicht geändert. |
|
Eine Zeichenfolge mit NULL-Beendigung, die den Anmeldenamen des Benutzers enthält, der diesem Eintrag zugeordnet ist. Wenn szUserName eine leere Zeichenfolge ist, wird der Benutzername nicht geändert. |
|
Eine null-endende Zeichenfolge, die das Kennwort für den durch szUserName angegebenen Benutzer enthält. Wenn szUserName eine leere Zeichenfolge ist, wird das Kennwort nicht geändert. Wenn szPassword eine leere Zeichenfolge und fRemovePasswordfalse ist, wird das Kennwort auf die leere Zeichenfolge festgelegt. Wenn fRemovePasswordTRUE ist, wird das kennwort, das in diesem Telefonbucheintrag für den durch szUserName angegebenen Benutzer gespeichert ist, unabhängig vom Inhalt der szPassword-Zeichenfolge entfernt.
Windows NT 4.0: Das Kennwort wird in die von szPassword angegebene Zeichenfolge geändert, unabhängig davon, ob szUserName eine leere Zeichenfolge ist. Windows XP/2000: Wenn szPassword das Kennworthandle enthält, das von RasGetCredentials oder RasGetEntryDialParams zurückgegeben wird, wird RasSetEntryDialParams erfolgreich zurückgegeben, ohne das aktuell gespeicherte Kennwort zu ändern. |
|
Eine NULL-Zeichenfolge, die den Namen der Domäne enthält, bei der sich angemeldet werden soll. Wenn szDomain eine leere Zeichenfolge ist, wird der Domänenname nicht geändert. |
|
Gibt den (einbasierten) Index des anfänglichen Unterversuchs an, der beim Herstellen der Verbindung gewählt werden soll. |
|
Gibt einen anwendungsdefinierten Wert an, den RAS an die RasDialFunc2-Rückruffunktion übergibt. |
[in] unnamedParam3
Gibt an, ob das gespeicherte Kennwort des Telefonbucheintrags für den durch lprasdialparams-szUserName> angegebenen Benutzer entfernt werden soll. Wenn fRemovePasswordauf TRUE festgelegt ist, wird das Kennwort entfernt. Das Festlegen von fRemovePassword auf TRUE entspricht dem Aktivieren des Kontrollkästchens "Kennwort speichern" in DFÜ-Netzwerk. Wenn Sie das Kennwort oder andere Eigenschaften eines Telefonbucheintrags festlegen, legen Sie fRemovePassword auf FALSE fest.
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 | BESCHREIBUNG |
---|---|
|
Die von lprasdialparams angegebene Adresse oder der Puffer ist ungültig. |
|
Das Telefonbuch ist beschädigt oder es fehlen Komponenten. |
|
Der Telefonbucheintrag ist nicht vorhanden. |
Hinweise
Verwenden Sie die RasSetEntryProperties-Funktion , um einen neuen Telefonbucheintrag zu erstellen.
Windows XP oder höher: Verwenden Sie nicht die RasSetEntryDialParams-Funktion . Verwenden Sie die RasSetCredentials-Funktion , um die Anmeldeinformationen für einen Telefonbucheintrag festzulegen. Legen Sie die Nicht-Anmeldeinformationsmember von RASDIALPARAMS (z. B. szCallbackNumber, dwSubEntry oder dwCallbackId) direkt in der RASDIALPARAMS-Struktur fest, die als Parameter an die RasDial-Funktion übergeben wird.
Hinweis
Der ras.h-Header definiert RasSetEntryDialParams als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, 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 |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für