RasSetEntryDialParamsA-Funktion (ras.h)

Artikel
03/06/2024

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
dwSize	Muss die Größe von (RASDIALPARAMS) angeben, um die Version der Struktur zu identifizieren.
szEntryName	Eine NULL-endende Zeichenfolge, die den Telefonbucheintrag identifiziert, für den Parameter festgelegt werden sollen.
szPhoneNumber	Wird nicht verwendet. Auf NULL festgelegt.
szCallbackNumber	Eine NULL-endende Zeichenfolge, die die Rückruftelefonnummer enthält. Wenn szCallbackNumber eine leere Zeichenfolge ist ( ""), wird die Rückrufnummer nicht geändert.
szUserName	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.
szPassword	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.
szDomain	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.
dwSubEntry	Gibt den (einbasierten) Index des anfänglichen Unterversuchs an, der beim Herstellen der Verbindung gewählt werden soll.
dwCallbackId	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
ERROR_BUFFER_INVALID	Die von lprasdialparams angegebene Adresse oder der Puffer ist ungültig.
ERROR_CANNOT_OPEN_PHONEBOOK	Das Telefonbuch ist beschädigt oder es fehlen Komponenten.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	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