Freigeben über


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
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

Weitere Informationen

RASDIALPARAMS

RasCreatePhonebookEntry

RasEditPhonebookEntry

RasGetEntryDialParams

RasSetCredentials

RasSetEntryProperties

Übersicht über ras (Remote Access Service, RAS)

Funktionen des RAS-Diensts